← All types
Ob Object

WorkflowExecutionStepState

A single step within a workflow execution

Fields

Unique identifier

Parent execution ID

nodeId

String!Non-null

Node ID from the workflow definition

Node name

Node type

wave

Int!Non-null

Execution wave (parallel step group)

Step status

Possible values (7)
PENDING

Step is waiting to execute

RUNNING

Step is currently executing

WAITING

Step is waiting for an external signal

COMPLETED

Step completed successfully

FAILED

Step failed with an error

SKIPPED

Step was skipped (condition not met)

WAITING_RETRY

Step is waiting for retry

input

String!Non-null

Step input as JSON

output

StringNullable

Step output as JSON (if completed)

error

StringNullable

Human-readable error message, including failed or cancelled delivery; never exposes the internal storage envelope

Structured failure code, node attribution and evidence when retained by the executor; null for legacy or unstructured messages

Start timestamp (ISO8601)

Completion timestamp (ISO8601)

Step duration in milliseconds

retryCount

Int!Non-null

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.

Referenced by (2)
Exact type 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
  """
  Human-readable error message, including failed or cancelled delivery; never exposes the internal storage envelope
  """
  error: String
  """
  Structured failure code, node attribution and evidence when retained by the executor; null for legacy or unstructured messages
  """
  structuredError: WorkflowExecutionErrorOutput
  """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
}