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.

Qoder Cloud Agents is a fully managed runtime for AI agents. You don’t have to build your own agent loop, manage tool execution sandboxes, or handle long-lived connections. Define an Agent and start a Session via API, and complex tasks run in the cloud while results stream back in real time.

​
Core Concepts

ConceptDescriptionAnalogy
AgentA reusable configuration template that defines the model, system prompt, and tool set”Job description”
EnvironmentThe container runtime for a Session, including network and dependency configuration”Desk and toolbox”
SessionA concrete instance of a conversation or task execution”A specific work session”
EventThe real-time event stream produced by a Session”Live progress feed”

​
Workflow

1

Define an Agent

Specify the model, system prompt, and available tools.
2

Configure an Environment

Choose the container type, networking policy, and preinstalled dependencies (or use the default environment).
3

Start a Session

Bind an Agent and Environment to create a runtime instance.
4

Send message + Stream events

Send a user.message to the Session and stream the Agent’s thinking, messages, and status changes over SSE (or fetch them via polling).

​
Verify Connectivity

# Verify the PAT and list all Agents
curl -s https://openapi.qoder.sh/api/v1/cloud/agents \
  -H "Authorization: Bearer $QODER_PAT"
A successful response looks like: 
{

  "data": [ ],

  "first_id": null,
  "last_id": null,
  "has_more": false
}

​
When to Use Cloud Agents

  • Long-running asynchronous tasks — code review, large refactors, automated test generation.
  • API integration — embed agent capabilities in backend services without maintaining a runtime.
  • Batch processing — fan out parallel Sessions to handle bulk requests.
  • Scheduled jobs — combine with a scheduler to run periodic inspections or reports.

​
Authentication

Every API request must include the following header:
HeaderValueDescription
AuthorizationBearer <PAT>Personal access token
Create your PAT under “Settings → Personal Access Tokens” in the Qoder console. Treat it as a secret and do not commit it to source control.

​
Pagination

List endpoints use cursor-based pagination with this response shape: 
{
  "data": [...],
  "first_id": "ag_abc123",
  "last_id": "ag_xyz789",
  "has_more": true
}
Use the after_id and before_id query parameters to page through results.

​
FAQ

Q: Can I use Cloud Agents and the Qoder CLI at the same time? A: Yes. The CLI is best for local interactive development; Cloud Agents is best for automation and integration. They complement each other. Q: How many Sessions can a single Agent run concurrently? A: There is no hard limit. The same Agent configuration can back many active Sessions simultaneously. Q: How is data secured? A: Each Session runs in an isolated container sandbox; Sessions cannot reach one another. Data is wiped when the environment is destroyed.

​
Next Steps