Read one run | Runtype Documentation

{
  "data": {
    "agentId": "string",
    "batchExecutionId": "string",
    "childCount": 1.1,
    "completeness": "partial",
    "conversationId": "string",
    "durationMs": 1.1,
    "endedAt": "string",
    "executionId": "string",
    "fidelityTier": "string",
    "flowId": "string",
    "inlineDefinition": true,
    "inputTokens": 1.1,
    "kind": "agent",
    "origin": "dashboard",
    "outputTokens": 1.1,
    "parentExecutionId": "string",
    "parentToolCallId": "string",
    "recordId": "string",
    "rootExecutionId": "string",
    "selfReportedCost": "string",
    "source": "hosted",
    "spanCount": 1.1,
    "startedAt": "string",
    "status": "queued",
    "storeResults": true,
    "surfaceId": "string",
    "surfaceType": "string",
    "totalCost": "string",
    "traceId": "string",
    "test": true,
    "agentTargetResolution": "string",
    "agentVersionId": "string",
    "agentVersionLabel": "string",
    "agentVersionNumber": 1.1,
    "budgetExhausted": true,
    "cacheReadTokens": 1.1,
    "cacheWriteTokens": 1.1,
    "cancelRequestedAt": "string",
    "expiresAt": "string",
    "inputMessages": null,
    "inputPreview": "string",
    "iterations": 1.1,
    "lastHeartbeatAt": "string",
    "otelProducer": null,
    "pendingApproval": null,
    "progress": null,
    "reasoningTokens": 1.1,
    "requestedFlowId": "string",
    "retentionElided": true,
    "stopReason": "string",
    "via": {
      "id": "string",
      "kind": "schedule",
      "label": "string"
    }
  }
}

One run the caller owns, in the row shape the list returns. An API key must hold the scope of the run’s own execution kind (AGENTS:READ or FLOWS:READ, and both when the run states neither). Use GET /v1/logs/trace/execution/{id} for its span tree.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

executionIdstringRequired

Query parameters

overlayenumOptional

live adds control-plane fields; defaults to live for a session, none for an API key.

Allowed values:

viewenumOptional

full (the default) returns every field. compact omits exactly these 15: stopReason, iterations, inputPreview, agentVersionId, agentVersionLabel, agentVersionNumber, agentTargetResolution, otelProducer, lastHeartbeatAt, expiresAt, cancelRequestedAt, progress, pendingApproval, budgetExhausted and inputMessages. The status is still overlay-corrected on a compact page; only the fields differ.

Allowed values:

Response

Run returned

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error