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

# AGENT API Overview: OpenAI Agents Surface

> Aria Compute AGENT API exposes the OpenAI beta Agents resource surface with persistent Postgres + pgvector state, plus JS and Python SDKs.

The AGENT API is Aria Compute's layered agent platform built on an OpenAI codex harness. It exposes the OpenAI beta Agents API so you can create agents, manage sessions, and persist state in Postgres with pgvector for per-principal `context_fragments`. You can use the API directly or through the JS and Python SDKs, which mirror the OpenAI Agents SDK.

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/api-reference/agent/authentication">
    Bearer and ApiKey schemes, self-serve key management
  </Card>

  <Card title="Create Agent" icon="plus" href="/api-reference/agent/agents/create">
    Create an agent with model, instructions, tools, and metadata
  </Card>

  <Card title="Create Session" icon="play" href="/api-reference/agent/sessions/create">
    Start a session for an existing agent and track its status
  </Card>

  <Card title="API Keys" icon="lock" href="/api-reference/agent/api-keys">
    Generate and manage API keys for programmatic access
  </Card>
</CardGroup>

## Base URL

```text theme={null}
https://agent.example.com
```

## Authentication

The API supports two header schemes:

* `Authorization: Bearer <api_key>`
* `Authorization: ApiKey <key>`

Authentication is optional when the server starts with `AGENT_CLOUD_API_KEY` unset. In that case, endpoints are open without an Authorization header. When the env is set, every request must include a valid key.

## Error format

Errors return the HTTP status code and a JSON body:

```json theme={null}
{
  "error": "Description of what went wrong"
}
```

## Versioning

Current endpoints are prefixed with `/v1` and follow the OpenAI beta Agents API shape. Some endpoints are recognized but return HTTP 501 Not Implemented:

* Vaults: `/v1/vaults*`
* Environments: `/v1/agents/environments*`
* Session artifacts: `/v1/agents/sessions/{id}/artifacts`


## Related topics

- [Authenticate with Aria Compute ROUTER](/api-reference/router/authentication.md)
- [POST /v1/chat/completions: OpenAI-compatible chat inference](/api-reference/router/openai/chat-completions.md)
- [Aria Compute ROUTER: OpenAI-compatible inference gateway](/api-reference/router/introduction.md)
- [Retrieve an Aria Agent Cloud Agent by ID](/api-reference/agent/agents/get.md)
- [List Agents - GET /v1/agents](/api-reference/agent/agents/list.md)