Documentation Index
Fetch the complete documentation index at: https://docs.snorbe.deskrex.ai/llms.txt
Use this file to discover all available pages before exploring further.
List Turns
Returns turns for the workspace associated with your API key, ordered newest first. Each turn includes the linked AgentRun information.
Request
| Header | Required | Description |
|---|
Authorization | Yes | API key in Bearer snorbe_... format |
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|
limit | integer | No | 10 | Items per page (1–50) |
cursor | string | No | - | nextCursor from previous page |
The workspace is automatically resolved from your API key. No parameters required.
Response
{
"turns": [
{
"id": "clxxx001",
"kind": "user",
"content": "Research the latest AI trends",
"agentRunId": null,
"createdAt": "2026-04-16T10:30:00.000Z",
"agentRun": null
},
{
"id": "clxxx002",
"kind": "assistant",
"content": "Here are the research findings...",
"agentRunId": "clyyy001",
"createdAt": "2026-04-16T10:30:05.000Z",
"agentRun": {
"id": "clyyy001",
"status": "completed",
"process": [],
"agent": { "id": "clzzz001", "name": "agent" },
"images": [
{
"imageUrl": "https://example.com/photo-1.jpg",
"thumbnailUrl": "https://example.com/thumb-1.jpg",
"title": "Lithium-ion battery diagram",
"link": "https://example.com/article-1"
}
]
}
}
],
"nextCursor": "clxxx003"
}
Response Fields
| Field | Type | Description |
|---|
turns | object[] | Turn array (newest first) |
turns[].id | string | Turn ID |
turns[].kind | string | user, assistant, error |
turns[].content | string | Turn content |
turns[].agentRunId | string | null | Linked AgentRun ID |
turns[].agentRun | object | null | AgentRun details |
turns[].agentRun.status | string | running, completed, failed, etc. |
turns[].agentRun.agent | object | Agent info |
turns[].agentRun.images | object[] | Images extracted from the process. Aggregated from search image SERPs, skill output files, and bodyLinks images in source summaries (deduplicated) |
turns[].agentRun.images[].imageUrl | string | Image URL |
turns[].agentRun.images[].thumbnailUrl | string | undefined | Thumbnail URL (present only when sourced via Serper) |
turns[].agentRun.images[].title | string | undefined | Image title / alt text |
turns[].agentRun.images[].link | string | undefined | URL of the originating page |
nextCursor | string | null | Cursor for next page (null = last page) |
Examples
# First page
curl "https://app.snorbe.deskrex.ai/api/v1/turn/list?limit=10" \
-H "Authorization: Bearer snorbe_your_api_key_here"
# Next page
curl "https://app.snorbe.deskrex.ai/api/v1/turn/list?limit=10&cursor=clxxx003" \
-H "Authorization: Bearer snorbe_your_api_key_here"
Error Responses
| HTTP Status | Code | Description |
|---|
| 401 | UNAUTHORIZED | Invalid, expired, or missing API key |
| 429 | TOO_MANY_REQUESTS | Rate limit exceeded |
