> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev.setoo.work/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Agentic OS API Documentation

> Use and leverage Agentic OS Voice AI using APIs through HTTP requests from any language

Use and leverage Agentic OS Voice AI using APIs through HTTP requests from any
language in your applications and workflows.

## What is the Agentic OS API?

The Agentic OS API enables you to programmatically create, configure, and manage
Voice AI agents from your own applications. Whether you are building complex
workflows, automating customer support, or integrating voice capabilities into your
existing products, our REST API provides everything you need.

The API uses predictable, resource-oriented URLs, accepts JSON-encoded request
bodies, returns JSON-encoded responses, and uses standard HTTP response codes and
authentication.

<Callout type="warning">
  You must have an active Agentic OS account to generate and use API keys. For instructions on creating keys, see the [API Keys Guide](/docs/features/api-keys).
</Callout>

## Authentication

All Agentic OS API endpoints require authentication using an API key, which you
create yourself from the platform dashboard. Include it in the `Authorization`
header of every request using the `Bearer` scheme.

```bash theme={null}
Authorization: Bearer aok_your_key_here
```

See [Authentication](/docs/api-reference/authentication) for the full walkthrough —
logging in, creating a key, and using it.

## Try it without writing code

Every endpoint page in this reference has a built-in request runner. Paste your
API key into the **Bearer Token** field, fill in the required parameters, and hit
**Send** to call the API against your own tenant and see the real response.

<Callout type="warning">
  The runner makes real API calls against your live tenant, with the same effects
  and billing as calling from your own code. Use a test agent while exploring.
</Callout>

## Base URL

```bash theme={null}
https://api.agentic-os.com/api/v1
```

<CardGroup cols={2}>
  <Card title="Authentication" href="/docs/api-reference/authentication" icon="key">
    Create an API key and run requests from the docs.
  </Card>

  <Card title="Pagination" href="/docs/api-reference/pagination" icon="list">
    How list endpoints paginate results.
  </Card>

  <Card title="Rate Limiting" href="/docs/api-reference/rate-limiting" icon="gauge">
    Request limits per plan tier.
  </Card>

  <Card title="Errors & Status Codes" href="/docs/api-reference/errors-status-codes" icon="triangle-exclamation">
    Standard error shape and HTTP codes.
  </Card>

  <Card title="Limits & Quotas" href="/docs/api-reference/limits-quotas" icon="chart-simple">
    Concurrency and usage quotas.
  </Card>
</CardGroup>