Skip to main content
The /v1 API is authenticated with an API key sent as a bearer token:
Responses are JSON with snake_case fields.

​
Rate limits

Requests are rate limited per API key. When you exceed the limit the API returns 429 Too Many Requests with a Retry-After header (seconds). Back off and retry.

​
Endpoints

​
Agents & runs

  • GET /v1/agents, POST /v1/agents
  • POST /v1/agents/{id}/versions
  • GET /v1/agents/{id}/runs
  • GET /v1/runs, GET /v1/runs/{id}
  • GET /v1/tools, POST /v1/tools

​
Knowledge

  • GET /v1/knowledge, POST /v1/knowledge, DELETE /v1/knowledge/{kb}
  • GET /v1/knowledge/{kb}/documents, POST /v1/knowledge/{kb}/documents
  • POST /v1/knowledge/search

​
Memory

  • GET /v1/memory, POST /v1/memory, DELETE /v1/memory/{id}
  • POST /v1/memory/search

​
Guardrails & prompts

  • GET /v1/guardrails, POST /v1/guardrails, DELETE /v1/guardrails/{name}
  • GET /v1/prompts, POST /v1/prompts, DELETE /v1/prompts/{name}