← API reference
CANONICAL TYPE REFERENCE

WorkflowExecutionState

A single execution instance of a workflow

Unique identifier

Tenant ID

Workflow ID being executed

Workflow name at query time (optional)

Workflow version ID being executed

Current execution status

Whether cancellation has been requested but not yet finalized

How the execution was triggered

inputString!

Input variables as JSON

outputString

Output variables as JSON (if completed)

Error details (if failed)

Start timestamp (ISO8601)

Completion timestamp (ISO8601)

Execution duration in milliseconds

Node ID that is waiting for a signal (when status is waiting)

Current execution wave (parallel step group)

Total number of waves in the workflow

System identifier that started the execution (for example a scheduler), when it was not started by a user. Null for user-started runs and for unrecognised ids.

Parent workflow. Requires workflow:read permission.

Workflow version used. Requires workflow:read permission.

Trigger that started this execution. Requires workflow:read permission.

Execution steps. Requires workflow:read permission.

Status of each recorded step, ordered by wave then start time: the run's path through the graph without step payloads. A node that repeats within the run appears once per step. Loaded in one batch per page, only when selected. Requires workflow:list permission.

User who started the execution, when it was started by a user in this tenant. Requires user:read permission.

View exact SDL
"""A single execution instance of a workflow"""
type WorkflowExecutionState {
  """Unique identifier"""
  id: WorkflowExecutionID!
  """Tenant ID"""
  tenantId: TenantID!
  """Workflow ID being executed"""
  workflowId: WorkflowID!
  """Workflow name at query time (optional)"""
  workflowName: String
  """Workflow version ID being executed"""
  versionId: WorkflowVersionID!
  """Current execution status"""
  status: ExecutionStatus!
  """Whether cancellation has been requested but not yet finalized"""
  cancellationRequested: Boolean!
  """How the execution was triggered"""
  triggerType: TriggerType!
  """Input variables as JSON"""
  input: String!
  """Output variables as JSON (if completed)"""
  output: String
  """Error details (if failed)"""
  error: WorkflowExecutionErrorOutput
  """Start timestamp (ISO8601)"""
  startedAt: ISO8601!
  """Completion timestamp (ISO8601)"""
  completedAt: ISO8601
  """Execution duration in milliseconds"""
  durationMs: Int
  """Node ID that is waiting for a signal (when status is waiting)"""
  waitingNodeId: String
  """Current execution wave (parallel step group)"""
  currentWave: Int!
  """Total number of waves in the workflow"""
  totalWaves: Int!
  """
  System identifier that started the execution (for example a scheduler), when it was not started by a user. Null for user-started runs and for unrecognised ids.
  """
  triggeredBySystem: String
  """Parent workflow. Requires workflow:read permission."""
  workflow: WorkflowState
  """Workflow version used. Requires workflow:read permission."""
  version: WorkflowVersionState
  """
  Trigger that started this execution. Requires workflow:read permission.
  """
  trigger: WorkflowTriggerState
  """Execution steps. Requires workflow:read permission."""
  steps: [WorkflowExecutionStepState!]!
  """
  Status of each recorded step, ordered by wave then start time: the run's path through the graph without step payloads. A node that repeats within the run appears once per step. Loaded in one batch per page, only when selected. Requires workflow:list permission.
  """
  stepStatuses: [WorkflowStepStatusSummary!]!
  """
  User who started the execution, when it was started by a user in this tenant. Requires user:read permission.
  """
  triggeredByUser: UserState
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.