Get run

getRun(command: RunsGetRunCommand!): RunsVersionedRun!

Arguments

ArgumentTypeRequiredDescription
commandRunsGetRunCommand!YesRead a run by its UUID or public run id (run_…), including its labels and grouped execution, control, usage and schema metadata. The returned ETag guards metadata updates.

Input fields

command

RunsGetRunCommand

FieldTypeRequiredDescription
runIdID!YesRun UUID, or any public run id (run_… or an older id) as legacy run reads, run events and usage records carry it. The response id is the run UUID that every other run operation takes.

Response

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

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.

All fields of RunsVersionedRun.

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

Example

graphql
query GetRun($command: RunsGetRunCommand!) {
  getRun(command: $command) {
    id
    projectId
    runId
    status
    createdAt
  }
}
json
{
  "command": {
    "runId": "11111111-1111-4111-8111-111111111111"
  }
}