← API reference
CANONICAL TYPE REFERENCE

WorkflowExecutionStepState

A single step within a workflow execution

Unique identifier

Parent execution ID

nodeIdString!

Node ID from the workflow definition

nodeNameString!

Node name

nodeTypeString!

Node type

waveInt!

Execution wave (parallel step group)

Step status

inputString!

Step input as JSON

outputString

Step output as JSON (if completed)

errorString

Error message (if failed)

Start timestamp (ISO8601)

Completion timestamp (ISO8601)

Step duration in milliseconds

Number of retries attempted so far (0 when the step has not been retried)

Maximum retries allowed for the step, when the node configures retries

When the next retry is scheduled (ISO8601), while the step is waiting to retry

Absolute deadline for the step (ISO8601), when the node has a timeout

Device the step is waiting to come online, when it is blocked on device availability

Parent execution. Requires workflow:read permission.

View exact SDL
"""A single step within a workflow execution"""
type WorkflowExecutionStepState {
  """Unique identifier"""
  id: WorkflowExecutionStepID!
  """Parent execution ID"""
  executionId: WorkflowExecutionID!
  """Node ID from the workflow definition"""
  nodeId: String!
  """Node name"""
  nodeName: String!
  """Node type"""
  nodeType: String!
  """Execution wave (parallel step group)"""
  wave: Int!
  """Step status"""
  status: StepStatus!
  """Step input as JSON"""
  input: String!
  """Step output as JSON (if completed)"""
  output: String
  """Error message (if failed)"""
  error: String
  """Start timestamp (ISO8601)"""
  startedAt: ISO8601
  """Completion timestamp (ISO8601)"""
  completedAt: ISO8601
  """Step duration in milliseconds"""
  durationMs: Int
  """
  Number of retries attempted so far (0 when the step has not been retried)
  """
  retryCount: Int!
  """Maximum retries allowed for the step, when the node configures retries"""
  maxRetries: Int
  """
  When the next retry is scheduled (ISO8601), while the step is waiting to retry
  """
  nextRetryAt: ISO8601
  """Absolute deadline for the step (ISO8601), when the node has a timeout"""
  timeoutAt: ISO8601
  """
  Device the step is waiting to come online, when it is blocked on device availability
  """
  waitingForDeviceId: DeviceID
  """Parent execution. Requires workflow:read permission."""
  execution: WorkflowExecutionState
}

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