List agent runs
list_agent_runsRead-onlyIdempotent
List the agent runs, live and finished, in the caller's accessible projects, newest first. Each run is one agent in its own sandbox. Returns id (the run's sandbox id), issueId, role, harness, status, instance type, and latest CPU/memory/disk metrics. When more runs match, nextCursor is set: pass it back as cursor, with the same filters, for the next page.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | Only the runs of this agent role | |
| limit | No | Max results (default 50). Narrow with projectId, issueId, role or status before raising it. | |
| cursor | No | nextCursor from the previous page; omit for the newest runs | |
| status | No | Filter by how the run stands: running, completed (finished), stopped (ended on purpose before it finished), failed, or stale (closed without a report) | |
| issueId | No | Only the runs of this mission, by its issue id, e.g. SHIP-412 | |
| projectId | No | Filter to one project id |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| nextCursor | Yes |