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 |
