API reference · Agents
Read a run
GET/v1/agents/{id}/runs/{run}API key
Its status, what it spent, its answer, or the calls it waits on. A 404 while hosted runs are off on the deployment.
Parameters
| Field | Type | What it is |
|---|---|---|
| id (path)required | string | The agent's id; self on an agent's own key. |
| run (path)required | string | The run's id, run_ and 24 hex digits. |
Answer 200
The run.
| Field | Type | What it is |
|---|---|---|
| object | string | One of "agent.run". |
| id | string | |
| agent_id | integer | |
| status | string | One of "queued", "in_progress", "requires_action", "cancelling", "completed", "incomplete", "failed", "cancelled", "expired". |
| model | string | |
| created | integer | |
| started_at | integer or null | |
| completed_at | integer or null | |
| expires_at | integer | |
| steps | integer | |
| max_steps | integer | |
| max_wall_seconds | integer | |
| cost_micros | integer | |
| max_cost_micros | integer | |
| usage | object | |
| usage. | integer | |
| usage. | integer | |
| output_text | string or null | |
| required_action | object or null | |
| required_action. | string | One of "submit_tool_outputs". |
| required_action. | object | |
| required_action. | array of object | |
| required_action. | string | |
| required_action. | string | One of "function". |
| required_action. | object | |
| required_action. | integer or null | |
| last_error | object or null | |
| last_error. | string | |
| last_error. | string | |
| incomplete_details | object or null | |
| incomplete_details. | string | One of "max_steps", "max_wall_time", "max_cost". |
| metadata | object or null |
Errors
- 401OpenAI shaped error.
- 403OpenAI shaped error.
- 404OpenAI shaped error.
Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.