| Field | Type | Description |
|---|---|---|
id | ID! | Unique run UUID. |
runId | ID! | 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. |
status | String! | Current execution state. |
projectId | ID! | Project containing the run. |
target | RunsRunTarget! | Execution definition; its ID may be null only on historical runs. |
input | JSON | Business input supplied when the run was created. |
output | JSON | Final business output; null until successful finalization. |
error | RunsRunError | Failure details, present only when the run failed. |
title | String | Display title, omitted when unset. |
labels | JSON | Labels used to organize runs. |
parentRunId | ID | Immediate parent run ID, present on child runs. |
rootRunId | ID | Top-level ancestor run ID, present on child runs. |
createdAt | String! | When the run was accepted. |
updatedAt | String! | When the resource last changed, including usage updates. |
startedAt | String | When the first execution attempt started, omitted before execution. |
finishedAt | String | When the run completed, failed or was cancelled. |
config | JSON | Definition-specific execution configuration. |
execution | RunsRunExecution | Resolved execution settings and diagnostics. |
control | RunsRunControl | Pending control requests and the current wait. |
taskId | ID | Orchestration task ID, distinct from the execution definition. |
conversationId | ID | Conversation containing the run. |
inputMessageId | ID | Conversation message that supplied the input. |
outputMessageId | ID | Conversation message containing the result. |
batchId | ID | Batch containing the run. |
trigger | RunsRunTrigger | How execution was initiated. |
usage | RunsRunUsage | Usage when available; unknown measurements are null. |
descendants | RunsRunDescendants | Counts and usage across all descendant runs, excluding this run. |
artifacts | [RunsRunArtifacts!] | Files produced by the run. |
schemas | RunsRunSchemas | Pinned schemas for business input and output; null means no declared schema. |
metadata | JSON | Additional resource metadata. |
etag | String! | Opaque metadata version to send in the If-Match request header on updateRun. |
RunsVersionedRun
Response type in the GraphQL API.
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.
All GraphQL types · Operations