# 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.