Skip to main content
GET
/
agents
/
{agent_id}
/
runs
/
{run_id}
Get run status
curl --request GET \
  --url https://api.push.ai/api/v1/agents/{agent_id}/runs/{run_id} \
  --header 'x-api-key: <api-key>'
{
  "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "running",
  "created_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "output": "<string>",
  "error": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Organization API key. Create one in the Push AI dashboard under Settings → API Keys.

Path Parameters

​
agent_id
integer
required

The ID of the agent that owns the run.

​
run_id
string<uuid>
required

The run ID returned by the create run endpoint.

Response

Current run status and result (if complete).

​
run_id
string<uuid>
required

Unique run identifier.

​
status
enum<string>
required

Current run status.

Available options:
running,
succeeded,
failed,
cancelled
​
created_at
string<date-time>
required

When the run was created.

​
completed_at
string<date-time> | null

When the run finished. null if still running.

​
output
string | null

The agent's final output. Only present when status is succeeded.

​
error
string | null

Error message. Only present when status is failed.