Run

Canonical execution summary. Agent, workflow, task, and existing eval kinds share this shape.

Field	Type	Description
`runId`	`ID!`
`id`	`ID!`	The run id. Same value as runId, which it replaces.
`kind`	`String!`
`status`	`String!`
`owner`	`RunOwner!`
`projectId`	`ID`	The project the run belongs to; null only for a run outside any project. With conversationId, replaces owner.
`conversationId`	`ID`
`messageId`	`ID`
`usage`	`RunUsage`
`toolErrorCount`	`Float!`
`childrenFailed`	`Boolean!`
`parentRunId`	`ID`
`rootRunId`	`ID!`
`waitingReason`	`String`
`waitingOn`	`[RunWaitingDependency!]`	Active dependencies while waitingReason is child_run: every listed run must finish first. Null otherwise.
`waiting`	`RunWaiting`	Why the run is waiting; null unless status is waiting. Replaces waitingReason and waitingOn.
`metadata`	`JSON`
`cancellation`	`RunCancellation`
`pause`	`RunPause`
`control`	`JSON`
`title`	`String`	The custom title set at creation with request.name; null when none was set.
`target`	`String`
`workflowId`	`String`
`scheduleId`	`ID`
`batchId`	`ID`
`runtimeTargetKind`	`String`
`runtimeTargetEnvironmentId`	`ID`
`runtimeTargetBranchId`	`ID`
`input`	`JSON`
`config`	`JSON`
`output`	`JSON`
`error`	`JSON`
`logs`	`String`
`artifacts`	`[JSON]!`
`durationMs`	`Float`
`exitCode`	`Float`
`startMode`	`String`
`timeoutSeconds`	`Float`
`backoffLimit`	`Float`
`inputSchemaSha256`	`String`
`outputSchemaSha256`	`String`
`inputSchemaHash`	`String`	sha256:<hex> of the declared input schema. Replaces inputSchemaSha256.
`outputSchemaHash`	`String`	sha256:<hex> of the declared output schema. Replaces outputSchemaSha256.
`trigger`	`RunTrigger`	How and by whom the run was started; null for runs recorded without a principal.
`triggerKind`	`String`
`triggerId`	`String`
`triggerPrincipalType`	`String`
`triggerPrincipalId`	`String`
`createdBy`	`String`
`updatedAt`	`String!`
`createdAt`	`String!`
`startedAt`	`String`
`completedAt`	`String`

All GraphQL types · Operations

Get started

APIs

REST API

GraphQL API

MCP API