List Agent Runs

List runs for an agent within a session, optionally filtered by status.

Useful for monitoring background runs and viewing run history.

GET /agents/{agent_id}/runs

List Agent Runs

cURL

curl --request GET \
  --url https://api.example.com/agents/{agent_id}/runs \
  --header 'Authorization: Bearer <token>'

400

{
  "detail": "Bad request",
  "error_code": "BAD_REQUEST"
}

Authorizations

Authorization · string · header · required

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

Path Parameters

agent_id · string · required

Query Parameters

session_id · string · required

Session ID to list runs for

status · string | null

Filter by run status (PENDING, RUNNING, COMPLETED, ERROR)

Response

200

application/json

List of runs retrieved successfully