List agent runs in the environment, optionally for one deployment or binding
GET /v1/runs · SDK listRuns · CLI deployments run list
Requires runs:read.
AuthorizationBearer <token>Opaque bearer credential scoped to one service account and tenant.
cursor?stringOpaque cursor returned by the previous page.
1 <= length <= 4096limit?integerMaximum number of resources to return.
1 <= value <= 100agentDeploymentId?stringAgent deployment whose runs should be returned. At most one of agentDeploymentId and executionBindingId may be set; with neither, every run in the environment is returned newest first.
executionBindingId?stringPreview or evaluation execution binding whose runs should be returned. At most one of agentDeploymentId and executionBindingId may be set.
agentReleaseId?stringOnly return runs pinned to this agent release.
status?stringOnly return runs in this status.
"canceled""completed""failed""queued""running""waiting-for-approval""waiting-for-tool"executionPurpose?stringOnly return runs executed for this purpose.
"customer""evaluation""preview"threadId?stringOnly return runs of this thread.
createdAfter?stringOnly return runs created at or after this canonical UTC millisecond timestamp.
date-timecreatedBefore?stringOnly return runs created at or before this canonical UTC millisecond timestamp.
date-timex-deployments-environment?stringRequired with a platform bearer JWT, where the three tenant headers select an environment the caller can access through active organization membership. Optional with an API key; when supplied, it must match the key's tenant.
^[0-7][0-9A-HJKMNP-TV-Z]{25}$x-deployments-organization?stringRequired with a platform bearer JWT, where the three tenant headers select an environment the caller can access through active organization membership. Optional with an API key; when supplied, it must match the key's tenant.
^[0-7][0-9A-HJKMNP-TV-Z]{25}$x-deployments-project?stringRequired with a platform bearer JWT, where the three tenant headers select an environment the caller can access through active organization membership. Optional with an API key; when supplied, it must match the key's tenant.
^[0-7][0-9A-HJKMNP-TV-Z]{25}$ListRunsResponse
application/json- response
nextCursor?|nullruns*array<>curl -X GET "https://example.com/v1/runs"{ "nextCursor": "string", "runs": [ { "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "version": 0, "environmentId": "string", "organizationId": "string", "projectId": "string", "workspaceId": "string", "agentDeploymentId": "string", "agentReleaseId": "string", "attempt": 0, "automation": { "fireId": "string", "id": "string", "kind": "heartbeat" }, "checkpointCount": 0, "completedAt": "2019-08-24T14:15:22Z", "error": { "property1": null, "property2": null }, "executionBindingId": "string", "executionPurpose": "customer", "executor": "string", "id": "string", "object": "run", "parentSpanId": "string", "priority": 0, "releaseSelection": "candidate", "replayedFromRunId": "string", "replayedFromTraceId": "string", "spanId": "string", "startedAt": "2019-08-24T14:15:22Z", "status": "canceled", "threadId": "string", "traceId": "string", "trigger": "string" } ]}