List runs

listRuns(command: RunsListRunsCommand!): RunsRunConnection!

Arguments

ArgumentTypeRequired
commandRunsListRunsCommand!Yes

Input fields

command

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

Response

Returns RunsRunConnection!. Open the type for its fields and nested types.

FieldTypeDescription
data[RunsRun!]!
pageInfoPageInfo!Opaque cursor for the next page; null means there are no more results.

Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

Example

graphql
query ListRuns($command: RunsListRunsCommand!) {
  listRuns(command: $command) {
    data {
      id
      projectId
      runId
      status
      createdAt
    }
    pageInfo {
      hasNextPage
      endCursor
      hasPreviousPage
      startCursor
    }
  }
}
json
{
  "command": {}
}