GET
/
status
/
{run_id}
curl --request GET \
  --url https://{agentSlug}.agent.itura.ai/status/{run_id} \
  --header 'Authorization: Bearer <token>'
{
  "run_id": "c631ab97-d42e-4704-8181-05bcd2eb37b5",
  "agent_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "agent_name": "your-agent-name-12345",
  "agent_url": "https://your-agent-name-12345.agent.itura.ai",
  "status": "COMPLETED",
  "created_at": "2023-10-27T10:00:00Z",
  "updated_at": "2023-10-27T10:05:00Z",
  "duration_ms": 3
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
run_id
string
required

The UUID of the agent run to check. Must be a valid version 4 UUID.

Response

200
application/json
Successfully retrieved the status of the agent run.
​
run_id
string
required

The UUID of the agent run.

Example:

"261aac1e-b040-4a0b-a31a-89dd7ca1f399"

​
status
enum<string>
required

The current status of the run.

Available options:
PENDING,
RUNNING,
COMPLETED,
FAILED
Example:

"COMPLETED"

​
agent_name
string
required

The name of the agent.

Example:

"My Agent"

​
agent_url
string
required

The URL of the agent.

Example:

"https://your-agent-name-12345.agent.itura.ai"

​
created_at
string
required

Timestamp when the run was created.

Example:

"2025-04-10T18:30:08.095695+00:00"

​
started_at
string
required

Timestamp when the run started executing.

Example:

"2025-04-10T18:30:08+00:00"

​
ended_at
string
required

Timestamp when the run finished executing.

Example:

"2025-04-10T18:30:08.402+00:00"

​
duration_ms
integer
required

Duration of the run in milliseconds.

Example:

3

​
output
object

The output of the agent run (present if status is COMPLETED).

​
error
object

Details about the error that occurred during the run (present if status is FAILED).