RunsRun

One execution resource returned by reads, creation, updates, and lifecycle actions. Omit irrelevant fields and empty groups. Errors appear only on failure; parent/root IDs only on child runs; timestamps appear when reached. Output is null until successful finalization.

FieldTypeDescription
idID!Unique run UUID.
runIdID!Public run ID that run events (metadata.run_id) and runtime tools name. Equals id for runs the server names; older runs keep their run_ ID.
statusString!Current execution state.
projectIdID!Project containing the run.
targetRunsRunTarget!Execution definition; its ID may be null only on historical runs.
inputJSONBusiness input supplied when the run was created.
outputJSONFinal business output; null until successful finalization.
errorRunsRunErrorFailure details, present only when the run failed.
titleStringDisplay title, omitted when unset.
labelsJSONLabels used to organize runs.
parentRunIdIDImmediate parent run ID, present on child runs.
rootRunIdIDTop-level ancestor run ID, present on child runs.
createdAtString!When the run was accepted.
updatedAtString!When the resource last changed, including usage updates.
startedAtStringWhen the first execution attempt started, omitted before execution.
finishedAtStringWhen the run completed, failed or was cancelled.
configJSONDefinition-specific execution configuration.
executionRunsRunExecutionResolved execution settings and diagnostics.
controlRunsRunControlPending control requests and the current wait.
taskIdIDOrchestration task ID, distinct from the execution definition.
conversationIdIDConversation containing the run.
inputMessageIdIDConversation message that supplied the input.
outputMessageIdIDConversation message containing the result.
batchIdIDBatch containing the run.
triggerRunsRunTriggerHow execution was initiated.
usageRunsRunUsageUsage when available; unknown measurements are null.
descendantsRunsRunDescendantsCounts and usage across all descendant runs, excluding this run.
artifacts[RunsRunArtifacts!]Files produced by the run.
schemasRunsRunSchemasPinned schemas for business input and output; null means no declared schema.
metadataJSONAdditional resource metadata.

All GraphQL types · Operations