List agent executions

GET

/v1/agents/:id/executions

GET

/v1/agents/:id/executions

$ curl https://api.runtype.com/v1/agents/id/executions \
>      -H "Authorization: <apiKey>"

1 {
2   "data": [
3     {
4       "agentId": "string",
5       "agentSource": "string",
6       "agentTargetResolution": "alias",
7       "agentVersion": {
8         "id": "string",
9         "label": "string",
10         "versionNumber": 1
11       },
12       "agentVersionId": "string",
13       "budgetExhausted": true,
14       "cancelRequestedAt": "string",
15       "completedAt": "string",
16       "conversationId": "string",
17       "createdAt": "string",
18       "executionId": "string",
19       "executionMode": "attached",
20       "expiresAt": "string",
21       "id": "string",
22       "iterations": 1,
23       "lastHeartbeatAt": "string",
24       "notificationMode": "none",
25       "parentAgentId": "string",
26       "parentConversationId": "string",
27       "parentExecutionId": "string",
28       "parentToolCallId": "string",
29       "pendingApproval": {
30         "approvalId": "string",
31         "requestedAt": "string",
32         "toolCallId": "string",
33         "toolName": "string",
34         "toolType": "string",
35         "description": "string",
36         "reason": "string",
37         "timeout": 1.1
38       },
39       "retryOfExecutionId": "string",
40       "rootExecutionId": "string",
41       "startedAt": "string",
42       "status": "queued",
43       "stopReason": "string",
44       "surfaceType": "string",
45       "totalCost": "string",
46       "finalOutput": null
47     }
48   ],
49   "pagination": {
50     "currentOffset": 1,
51     "hasMore": true,
52     "hasPrev": true,
53     "limit": 1,
54     "nextCursor": "string",
55     "prevCursor": "string",
56     "currentPage": 1,
57     "totalCount": 1,
58     "totalPages": 1
59   }
60 }

List execution history for an agent with cursor pagination. Rows include finalOutput by default; pass view=compact for the lighter projection that omits it and previews long strings. Supports cross-agent subagent drill-down via parentExecutionId or executionId filters.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

Query parameters

limitstringOptional

cursorstringOptional

includeCountstringOptional

statusenumOptional

surfaceTypestringOptional

fromstringOptional

tostringOptional

parentExecutionIdstringOptional

executionIdstringOptional

viewenumOptional

Response representation. full (default) preserves complete values and includes each row’s finalOutput; compact omits finalOutput and shortens every remaining string value longer than 100 characters to a 100-character preview followed by ….

Allowed values:

Response

Paginated list of agent executions

datalist of objects

paginationobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error