Skip to main content

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.

​
Get Agent Run Detail

Returns the full details of an agent run, including the complete process timeline, linked sources, and linked entities. Unlike the lightweight status endpoint, this returns the entire process event array.

​
Request

GET /api/v1/agent/run/{runId}

​
Path Parameters

ParameterTypeDescription
runIdstringAgent run ID

​
Headers

HeaderRequiredDescription
AuthorizationYesAPI key in Bearer snorbe_... format
The workspace is automatically resolved from your API key. No workspaceId parameter required.
This endpoint returns the full process timeline which can be large for long-running agent executions. For lightweight status polling, use the Get Run Status endpoint instead.

​
Response

{
  "id": "clrun001",
  "status": "completed",
  "process": [],
  "createdAt": "2026-04-01T09:00:00.000Z",
  "updatedAt": "2026-04-01T09:05:00.000Z",
  "agentId": "clagent001",
  "agentName": "research-agent",
  "linkedSources": [
    {
      "id": "clsrc001",
      "url": "https://example.com/paper",
      "title": "Research Paper",
      "sourceType": "public"
    },
    {
      "id": "clsrc002",
      "url": "https://example.com/report",
      "title": "Industry Report",
      "sourceType": "private"
    }
  ],
  "linkedEntityIds": ["clxxx001", "clxxx002", "clxxx003"],
  "linkedEntities": [
    {
      "id": "clxxx001",
      "label": "Lithium-Ion Battery",
      "category": "technology",
      "kind": "entity"
    },
    {
      "id": "clxxx002",
      "label": "Solid-State Electrolyte",
      "category": "technology",
      "kind": "material"
    }
  ],
  "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"
    }
  ]
}
Returns null if the agent run is not found.

​
Response Fields

FieldTypeDescription
idstringAgent run ID
statusstringRun status (completed, running, error, etc.)
processobject[]Array of process events from the agent run
createdAtstringRun creation timestamp (ISO 8601)
updatedAtstringRun last update timestamp (ISO 8601)
agentIdstringAgent ID that executed this run
agentNamestringAgent name
linkedSourcesobject[]Sources used in this agent run
linkedSources[].idstringSource ID
linkedSources[].urlstringSource URL
linkedSources[].titlestringSource title
linkedSources[].sourceTypestringSource type (public or private)
linkedEntityIdsstring[]Entity IDs linked to this agent run
linkedEntitiesobject[]Entity summaries linked to this agent run
linkedEntities[].idstringEntity ID
linkedEntities[].labelstringEntity name
linkedEntities[].categorystringEntity category
linkedEntities[].kindstringEntity kind
imagesobject[]Images extracted from the process. Aggregated from search image SERPs, skill output files, and bodyLinks images in source summaries (deduplicated)
images[].imageUrlstringImage URL
images[].thumbnailUrlstring | undefinedThumbnail URL (present only when sourced via Serper)
images[].titlestring | undefinedImage title / alt text
images[].linkstring | undefinedURL of the originating page
The process field is an array of process events collected during the agent run. See the SSE streaming docs for the full list of event types and their payloads.

​
Examples

curl "https://app.snorbe.deskrex.ai/api/v1/agent/run/clrun001" \
  -H "Authorization: Bearer snorbe_your_api_key_here"

​
Error Responses

HTTP StatusDescription
401Invalid, expired, or missing API key
404Agent run not found (returns null body)