| Field | Type | Required | Description |
|---|---|---|---|
taskId | ID | No | Discover agent runs with this persisted task identity across conversations. Matches canonical task metadata or the first enqueue request; results are not task authorization evidence. |
limit | Float | No | Maximum number of records in a page, from 1 to 100. Defaults to 20. |
cursor | String | No | Opaque cursor returned by the previous page. Reuse with unchanged filters and ordering. |
sortBy | String | No | Field used to order runs: created_at, status or duration. Defaults to created_at. |
sortOrder | String | No | Sort direction: asc or desc. Defaults to desc. |
status | [String!] | No | Run statuses to include. Values within this filter use OR; different filters use AND. |
targetType | [String!] | No | Execution definition types to include: agent, task, workflow or legacy eval. |
triggerType | [String!] | No | Trigger types to include: user, api_key, service_account, system, schedule, webhook, agent, task or workflow. |
rootOnly | Boolean | No | true lists only top-level runs (parent_run_id null). Defaults to false. |
parentRunId | ID | No | |
targetId | [ID!] | No | |
triggerId | ID | No | |
projectReference | ID | No | |
conversationId | ID | No |
RunsListRunsCommand
Input object in the GraphQL API.