RunsListRunsCommand

RunsListRunsCommand

FieldTypeRequiredDescription
taskIdIDNoDiscover agent runs with this persisted task identity across conversations. Matches canonical task metadata or the first enqueue request; results are not task authorization evidence.
limitFloatNoMaximum number of records in a page, from 1 to 100. Defaults to 20.
cursorStringNoOpaque cursor returned by the previous page. Reuse with unchanged filters and ordering.
sortByStringNoField used to order runs: created_at, status or duration. Defaults to created_at.
sortOrderStringNoSort direction: asc or desc. Defaults to desc.
status[String!]NoRun statuses to include. Values within this filter use OR; different filters use AND.
targetType[String!]NoExecution definition types to include: agent, task, workflow or legacy eval.
triggerType[String!]NoTrigger types to include: user, api_key, service_account, system, schedule, webhook, agent, task or workflow.
rootOnlyBooleanNotrue lists only top-level runs (parent_run_id null). Defaults to false.
parentRunIdIDNo
targetId[ID!]No
triggerIdIDNo
projectReferenceIDNo
conversationIdIDNo

All GraphQL types · Operations