List Turns

Returns turns for the workspace associated with your API key, ordered newest first. Each turn includes the linked AgentRun information.

Request

GET /api/v1/turn/list

Headers

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"

import requests

base_url = "https://app.snorbe.deskrex.ai/api/v1/turn/list"
headers = {"Authorization": "Bearer snorbe_your_api_key_here"}
cursor = None

while True:
    params = {"limit": 10}
    if cursor:
        params["cursor"] = cursor
    resp = requests.get(base_url, params=params, headers=headers)
    data = resp.json()
    for turn in data["turns"]:
        print(f"[{turn['kind']}] {turn['content'][:50]}")
    cursor = data.get("nextCursor")
    if not cursor:
        break

const baseUrl = "https://app.snorbe.deskrex.ai/api/v1/turn/list";
const headers = { Authorization: "Bearer snorbe_your_api_key_here" };

let cursor: string | undefined;
do {
  const url = cursor
    ? `${baseUrl}?limit=10&cursor=${cursor}`
    : `${baseUrl}?limit=10`;
  const resp = await fetch(url, { headers });
  const data = await resp.json();
  for (const turn of data.turns) {
    console.log(`[${turn.kind}] ${turn.content.slice(0, 50)}`);
  }
  cursor = data.nextCursor ?? undefined;
} while (cursor);

Error Responses

HTTP Status	Code	Description
401	`UNAUTHORIZED`	Invalid, expired, or missing API key
429	`TOO_MANY_REQUESTS`	Rate limit exceeded