Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

The Qoder Cloud Agents API provides full management capabilities for cloud-hosted AI Agents, covering Agent creation, environment configuration, session management, event streaming, and more. All endpoints follow REST conventions and use JSON for requests and responses.
The API is currently in Beta. Some functionality may change in future releases.

​
Gateway URL

EnvironmentURL
Productionhttps://api.qoder.com/api/v1/cloud

​
Versioning

The API is currently at version v1. All endpoints are versioned through the /v1/ URL prefix — no additional version header is required.

​
Available APIs

ResourceDescriptionBase path
AgentsAgent CRUD and archival/agents
EnvironmentsRuntime environment configuration/environments
SessionsAgent session creation and lifecycle/sessions
EventsSession event stream reads and pushes/events
FilesFile upload and association/files
VaultsSecure storage for sensitive credentials/vaults
SkillsAgent skill registration and management/skills
Memory StoresPersistent memory storage/memory_stores

​
Request size limits

  • Maximum request body size: 32 MB
  • Requests exceeding this limit return 400 invalid_request_error.

​
Required headers

Every API request must include the authentication header; Content-Type is recommended but not mandatory — the server can auto-detect: 
Authorization: Bearer $QODER_PAT
Content-Type: application/json  # recommended but not mandatory, server can auto-detect

​
Beta status

  1. The API surface is broadly stable, but signatures may receive minor adjustments in future iterations.
  2. New functionality ships behind new beta identifiers.
  3. Lock the API version and add compatibility handling when running in production.
  4. All current features are available without an additional Beta header.

​
Quick connectivity check

# List Agents under the current account (verifies auth and connectivity)
curl -s https://api.qoder.com/api/v1/cloud/agents?limit=1 \
  -H "Authorization: Bearer $QODER_PAT"
Successful response: 
{
  "data": [],
  "first_id": null,
  "last_id": null,
  "has_more": false
}

​
Rate Limiting

The API application layer currently has no active rate limiting. The gateway layer has global burst traffic suppression and DDoS protection, which may return 429 or 503 when triggered. Clients should implement exponential backoff retry for 5xx/429 (1s → 2s → 4s, max 3 retries).

​
Next steps