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/{agent_id}/versions
Returns the version history of the specified Agent, sorted by version number in descending order (newest first).
| Header | Required | Description |
|---|
Authorization | Yes | Bearer <PAT> |
Path parameters
| Parameter | Type | Required | Description |
|---|
agent_id | string | Yes | Agent unique identifier |
Query parameters
| Parameter | Type | Required | Default | Description |
|---|
limit | integer | No | 20 | Items per page |
order | string | No | desc | Sort direction, "asc" or "desc" |
after_id | string | No | — | Cursor; returns versions after this one |
before_id | string | No | — | Cursor; returns versions before this one |
Example request
curl -X GET "https://openapi.qoder.sh/api/v1/cloud/agents/agent_019eXXXX.../versions" \
-H "Authorization: Bearer $QODER_PAT"
Example response
HTTP 200 OK
{
"data": [
{
"type": "agent",
"id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"name": "doc-test-agent-updated",
"description": "Used for API documentation testing",
"model": "ultimate",
"system": "You are an updated documentation testing assistant.",
"instructions": "You are an updated documentation testing assistant.",
"tools": [],
"mcp_servers": [],
"default_environment": "",
"version": 2,
"created_at": "2026-05-18T15:26:39.61669Z",
"updated_at": "2026-05-18T15:27:07.967138Z"
},
{
"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"
}
],
"first_id": "2",
"last_id": "1",
"has_more": false
}
Response fields
| Field | Type | Description |
|---|
data | array | Array of Agent version snapshots; each element is the full Agent object at that version |
first_id | string | Version identifier of the first record on this page |
last_id | string | Version identifier of the last record on this page |
has_more | boolean | Whether more versions remain |
Version history
- Every successful
PUT on an Agent creates a new version.
- Versions start at 1 and increment on each update.
- Each version stores the full Agent snapshot at that point in time.
- Useful for auditing changes or reference during rollback.
Errors
| HTTP | Type | Trigger |
|---|
| 401 | authentication_error | PAT invalid or expired |
| 403 | permission_error | Not authorized for this Agent |
| 404 | not_found_error | Agent with the given ID does not exist |
Notes
- For this endpoint,
first_id and last_id are the version numbers as strings (such as "1", "2").
- Versions are sorted in descending order by default (latest first).
- Combine with the OCC mechanism on
PUT to track configuration changes.
