Get execution detail

GET

/v1/agents/:id/executions/:executionId

GET

/v1/agents/:id/executions/:executionId

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

1 {
2   "agentId": "agent_9f8b7c6d5e4a3b2c1d0e",
3   "agentSource": "https://github.com/runtype/agents/sample-agent",
4   "cancelRequestedAt": "2024-06-10T15:45:30Z",
5   "completedAt": "2024-06-10T15:50:00Z",
6   "createdAt": "2024-06-10T15:30:00Z",
7   "executionId": "exec_1234567890abcdef",
8   "executionMode": "attached",
9   "expiresAt": "2024-06-17T15:30:00Z",
10   "id": "run_abcdef1234567890",
11   "iterations": 5,
12   "lastHeartbeatAt": "2024-06-10T15:49:55Z",
13   "notificationMode": "none",
14   "parentAgentId": "agent_parent_0987654321fedcba",
15   "parentConversationId": "conv_1122334455667788",
16   "parentExecutionId": "exec_parent_abcdef123456",
17   "parentToolCallId": "toolcall_9988776655443322",
18   "pendingApproval": {
19     "approvalId": "approval_0011223344556677",
20     "requestedAt": "2024-06-10T15:40:00Z",
21     "toolCallId": "toolcall_9988776655443322",
22     "toolName": "ExternalAPIConnector",
23     "toolType": "api",
24     "description": "Approval required to proceed with external API call",
25     "reason": "External API quota limit reached",
26     "timeout": 300
27   },
28   "retryOfExecutionId": "exec_retry_1234abcd5678efgh",
29   "rootExecutionId": "exec_root_abcdefabcdefabcd",
30   "startedAt": "2024-06-10T15:30:05Z",
31   "status": "queued",
32   "stopReason": "User requested cancellation",
33   "surfaceType": "web",
34   "totalCost": "0.0234"
35 }

Get full details for a single agent execution including final output, iteration details, and loop configuration.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

executionIdstringRequired

Response

Execution detail

agentIdstring or null

agentSourcestring or null

cancelRequestedAtstring or null

completedAtstring or null

createdAtstring

executionIdstring

executionModeenum

expiresAtstring or null

idstring

iterationsinteger or null

lastHeartbeatAtstring or null

notificationModeenum

parentAgentIdstring or null

parentConversationIdstring or null

parentExecutionIdstring or null

parentToolCallIdstring or null

pendingApprovalobject or null

retryOfExecutionIdstring or null

rootExecutionIdstring or null

startedAtstring or null

statusenum

stopReasonstring or null

surfaceTypestring or null

totalCoststring or null

agentSpecany

finalOutputany

inputMessagesany

iterationDetailsany

loopConfigany

progressany

totalTokensany

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error