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.
GET /v1/agents
Lists all Agents under the current account. Supports pagination and ordering.
| Header | Required | Description |
|---|
Authorization | Yes | Bearer <PAT> |
Query parameters
| Parameter | Type | Required | Default | Description |
|---|
limit | integer | No | 20 | Items per page, range 1–100 |
order | string | No | desc | Sort direction, "asc" or "desc" |
after_id | string | No | — | Cursor; returns records after this ID |
before_id | string | No | — | Cursor; returns records before this ID |
Example request
curl -X GET "https://openapi.qoder.sh/api/v1/cloud/agents?limit=2&order=desc" \
-H "Authorization: Bearer $QODER_PAT"
Example response
HTTP 200 OK
{
"data": [
{
"type": "agent",
"id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"name": "doc-test-agent",
"description": "",
"model": "ultimate",
"system": "You are a documentation testing assistant.",
"instructions": "You are a documentation testing assistant.",
"tools": [],
"mcp_servers": [],
"default_environment": "",
"version": 1,
"created_at": "2026-05-18T15:26:39.61669Z",
"updated_at": "2026-05-18T15:26:39.61669Z"
},
{
"type": "agent",
"id": "agent_019eYYYYYYYYYYYYYYYYYYYYYYYYYYYY",
"name": "test-agent-e2e",
"description": "Agent used for end-to-end testing",
"model": "ultimate",
"system": "You are a testing assistant.",
"instructions": "You are a testing assistant.",
"tools": [],
"mcp_servers": [],
"default_environment": "",
"version": 2,
"created_at": "2026-05-18T03:04:33.952256Z",
"updated_at": "2026-05-18T03:05:28.023697Z"
}
],
"first_id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"last_id": "agent_019eYYYYYYYYYYYYYYYYYYYYYYYYYYYY",
"has_more": true
}
Response fields
| Field | Type | Description |
|---|
data | array | Array of Agent objects |
first_id | string | ID of the first record on this page |
last_id | string | ID of the last record on this page |
has_more | boolean | Whether more records remain |
curl "https://openapi.qoder.sh/api/v1/cloud/agents?limit=20&after_id=agent_019eYYYY..."
curl "https://openapi.qoder.sh/api/v1/cloud/agents?limit=20&before_id=agent_019eXXXX..."
Errors
| HTTP | Type | Trigger |
|---|
| 401 | authentication_error | PAT invalid or expired |
| 403 | permission_error | Not authorized for this operation |
| 400 | invalid_request_error | limit out of range or invalid parameter |
Notes
- Records are returned in descending creation time by default (newest first).
- Archived Agents do not appear in the default listing.
- Pagination is cursor-based; offset-based pagination is not supported.
