> ## 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
> Retrieve the full details of an agent run including process timeline, linked sources, and linked entities
# 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](/en/api-reference/get-run-status), this returns the entire process event array.
## Request
```
GET /api/v1/agent/run/{runId}
```
### Path Parameters
| Parameter | Type | Description |
| --------- | -------- | ------------ |
| `runId` | `string` | Agent run ID |
### Headers
| Header | Required | Description |
| --------------- | -------- | ------------------------------------- |
| `Authorization` | Yes | API 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](/en/api-reference/get-run-status) endpoint instead.
## Response
```json theme={null}
{
"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
| Field | Type | Description |
| ---------------------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | `string` | Agent run ID |
| `status` | `string` | Run status (`completed`, `running`, `error`, etc.) |
| `process` | `object[]` | Array of process events from the agent run |
| `createdAt` | `string` | Run creation timestamp (ISO 8601) |
| `updatedAt` | `string` | Run last update timestamp (ISO 8601) |
| `agentId` | `string` | Agent ID that executed this run |
| `agentName` | `string` | Agent name |
| `linkedSources` | `object[]` | Sources used in this agent run |
| `linkedSources[].id` | `string` | Source ID |
| `linkedSources[].url` | `string` | Source URL |
| `linkedSources[].title` | `string` | Source title |
| `linkedSources[].sourceType` | `string` | Source type (`public` or `private`) |
| `linkedEntityIds` | `string[]` | Entity IDs linked to this agent run |
| `linkedEntities` | `object[]` | Entity summaries linked to this agent run |
| `linkedEntities[].id` | `string` | Entity ID |
| `linkedEntities[].label` | `string` | Entity name |
| `linkedEntities[].category` | `string` | Entity category |
| `linkedEntities[].kind` | `string` | Entity kind |
| `images` | `object[]` | Images extracted from the process. Aggregated from search image SERPs, skill output files, and bodyLinks images in source summaries (deduplicated) |
| `images[].imageUrl` | `string` | Image URL |
| `images[].thumbnailUrl` | `string \| undefined` | Thumbnail URL (present only when sourced via Serper) |
| `images[].title` | `string \| undefined` | Image title / alt text |
| `images[].link` | `string \| undefined` | URL of the originating page |
The `process` field is an array of process events collected during the agent run. See the [SSE streaming docs](/en/api-reference/stream-agent-run) for the full list of event types and their payloads.
## Examples
```bash cURL theme={null}
curl "https://app.snorbe.deskrex.ai/api/v1/agent/run/clrun001" \
-H "Authorization: Bearer snorbe_your_api_key_here"
```
```python Python theme={null}
import requests
resp = requests.get(
"https://app.snorbe.deskrex.ai/api/v1/agent/run/clrun001",
headers={"Authorization": "Bearer snorbe_your_api_key_here"},
)
data = resp.json()
if data:
print(f"Run: {data['id']} ({data['status']})")
print(f"Agent: {data['agentName']}")
print(f"Sources: {len(data['linkedSources'])}")
print(f"Entities: {len(data['linkedEntities'])}")
print(f"Process events: {len(data['process'])}")
else:
print("Agent run not found")
```
```typescript TypeScript theme={null}
const resp = await fetch(
"https://app.snorbe.deskrex.ai/api/v1/agent/run/clrun001",
{ headers: { Authorization: "Bearer snorbe_your_api_key_here" } },
);
const data = await resp.json();
if (data) {
console.log(`Run: ${data.id} (${data.status})`);
console.log(`Agent: ${data.agentName}`);
console.log(`Sources: ${data.linkedSources.length}`);
console.log(`Entities: ${data.linkedEntities.length}`);
console.log(`Process events: ${data.process.length}`);
}
```
## Error Responses
| HTTP Status | Description |
| ----------- | ----------------------------------------- |
| 401 | Invalid, expired, or missing API key |
| 404 | Agent run not found (returns `null` body) |