List child agent runs

childAgentRuns(conversationId: ID!, parentRunId: ID!, spawnedFromToolCallId: String): [AgentRun!]!

Arguments

ArgumentTypeRequiredDescription
conversationIdID!Yes
parentRunIdID!YesParent run. This list is unpaged; page with childAgentRunsConnection.
spawnedFromToolCallIdStringNo

Response

Returns [AgentRun!]!. Open the type for its fields and nested types.

FieldTypeDescription
runIdID!
conversationIdID
messageIdIDNull when no message is attached to the run.
projectIdID
requestedByUserIdID!
triggerPrincipalTypeStringAuthenticated principal type that fired the run: system, user, api_key or service_account. Null for legacy rows.
triggerPrincipalIdStringStable identifier of the authenticated principal that fired the run. Null for legacy rows.
agentIdString!

All fields of AgentRun.

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

Example

graphql
query ChildAgentRuns($conversationId: ID!, $parentRunId: ID!, $spawnedFromToolCallId: String) {
  childAgentRuns(conversationId: $conversationId, parentRunId: $parentRunId, spawnedFromToolCallId: $spawnedFromToolCallId) {
    projectId
    runId
    agentId
    status
    createdAt
  }
}
json
{
  "conversationId": "00000000-0000-4000-8000-000000000001",
  "parentRunId": "00000000-0000-4000-8000-000000000001"
}