List Agent Runs

Status filtering

Current status strings are PENDING, RUNNING, COMPLETED, PAUSED, CANCELLED, ERROR and REGENERATED. Filtering is case-sensitive; an unknown string returns no matching runs rather than an enum-validation error.

Results belong to the requested session and path agent. This endpoint does not return every nested member run in the session.

GET/agents/{agent_id}/runs

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

Useful for monitoring background runs and viewing run history.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

agent_id*Agent Id

Query Parameters

session_id*Session Id

Session ID to list runs for

status?|

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

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl --request GET 'https://example.com/agents/string/runs?session_id=string'
null