Skip to main content
POST
Query agent runs

Headers

x-project-id
string<uuid>
required

Project ID for tenant scoping

X-Workspace-Id
string<uuid> | null

Overrides the key's workspace

X-API-Key
string | null

User API key

Body

application/json
scope
enum<string>
required

Which run view: task_runs, agent_runs, or run_progress

Available options:
task_runs,
agent_runs,
run_progress
task_id
string<uuid> | null

Task id; required for task_runs and run_progress

agent_id
string<uuid> | null

Agent id; required for agent_runs

run_id
string<uuid> | null

Run id; required for run_progress

cursor
string | null

Pagination cursor for the run list scopes

limit
integer
default:50

Page size for the run list scopes

Required range: 1 <= x <= 100

Response

Successful Response

items
AgentRunResponse · object[]
required
next_cursor
string | null