Skip to main content
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.

Authentication

Bearer and ApiKey schemes, self-serve key management

Create Agent

Create an agent with model, instructions, tools, and metadata

Create Session

Start a session for an existing agent and track its status

API Keys

Generate and manage API keys for programmatic access

​
Base URL

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

​
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