latestOpenAPI 3.1.02026-08-0858116535.1 KB

5c7114e0ef43

Agent

Get a run

Retrieve a single Agent run by ID.

get/agent/runs/{id}

Path parameters

idstring required

Agent run ID. New run IDs are returned with the agent_run_ prefix.

Example:agent_run_01j7x9v0m2n4p6q8r0s2t4v6w8

Agent run ID.

Response

Agent run

idstring required

Agent run ID. New run IDs are returned with the agent_run_ prefix.

object'agent_run' required

status'queued' | 'running' | 'completed' | 'failed' | 'cancelled' required

stopReason'schema_satisfied' | 'budget_reached' | 'error' | 'cancelled' required

createdAtstring date-time required

When the run was created

completedAtstring date-time nullable required

Example response

{
  "id": "agent_run_01j7x9v0m2n4p6q8r0s2t4v6w8",
  "request": {
    "query": "What are the most important AI infrastructure funding rounds announced this week?",
    "systemPrompt": "Prefer official sources and avoid duplicate results.",
    "previousRunId": "agent_run_01j7x9v0m2n4p6q8r0s2t4v6w8",
    "metadata": {
      "slack_channel_id": "C123ABC",
      "slack_thread_id": "1745444400.123456",
      "user_id": "U123ABC"
    },
    "budget": {
      "maxCostDollars": 10
    }
  },
  "output": {
    "grounding": [
      {
        "field": "structured.companies[0].sourceUrl"
      }
    ]
  }
}