Get a managed agent run | Runtype Documentation

{
  "outputs": [
    {
      "anthropicFileId": "file_8a7b9c3d",
      "assetRef": "assets/agent123/run456/output1.png",
      "createdAt": "2024-06-10T15:22:30Z",
      "filename": "result_image.png",
      "id": "mao_9f8e7d6c",
      "mimeType": "image/png",
      "sizeBytes": 245678
    }
  ],
  "run": {
    "agentId": "agent_123abc",
    "conversationId": "conv_789xyz",
    "costThousandths": 1250,
    "createdAt": "2024-06-10T15:20:00Z",
    "error": null,
    "executionId": "exec_456def",
    "finalText": "The task completed successfully with all deliverables generated.",
    "id": "mar_456def",
    "inputTokens": 350,
    "lastEventSeq": 42,
    "outputTokens": 420,
    "settledAt": "2024-06-10T15:22:45Z",
    "startedAt": "2024-06-10T15:20:05Z",
    "status": "completed"
  }
}

Fetch one durable run summary plus its deliverable pointers (the swept /mnt/session/outputs/ files; the bytes live in asset storage). Auth: agent ownership + AGENTS:READ.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

runIdstringRequired

Response

The run summary and its deliverables

outputslist of objects

runobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

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