> For the complete documentation index, see [llms.txt](https://docs.wobby.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wobby.ai/settings/public-api.md).

# Public API

The Actian AI Analyst Public API gives you programmatic access to your environment — without logging into the UI. Use it to build integrations, automate workflows, and connect Actian AI Analyst to your existing tooling.

Common use cases include:

* **Version-controlling your semantic layer** by exporting models, metrics, glossary terms, and agents to a Git repository
* **Automating deployments** using CI/CD pipelines (e.g. promote changes from dev → staging → production)
* **Integrating with external tools** that need to read or push definitions from your environment

## Authentication

All Public API requests authenticate with an **API key** passed as a Bearer token in the `Authorization` header. API keys are scoped to your organization and are managed by [Admins](/settings/members.md) in **Studio > Settings > API Keys**.

```
Authorization: Bearer sk_...
```

See [API Keys](/settings/public-api/api-keys.md) for how to create and manage keys.

## Base URL

```
https://app.wobby.ai/api/public/v1
```

## Rate limits

The Public API enforces rate limiting per IP address:

| Limit                     | Value           |
| ------------------------- | --------------- |
| Max requests              | 2 per 5 seconds |
| Ban duration on violation | 1 hour          |

Design your integrations to stay within this limit — exceeding it will block your IP for 1 hour.

## Next steps

* [Set up an API key](/settings/public-api/api-keys.md)
* [Explore the API reference](https://docs.wobby.ai/api-reference)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.wobby.ai/settings/public-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.