WorkflowExecutionStepState
A single step within a workflow execution
Fields
Unique identifier
Parent execution ID
Node ID from the workflow definition
Node name
Node type
Execution wave (parallel step group)
Step status
Possible values (7)
PENDINGStep is waiting to execute
RUNNINGStep is currently executing
WAITINGStep is waiting for an external signal
COMPLETEDStep completed successfully
FAILEDStep failed with an error
SKIPPEDStep was skipped (condition not met)
WAITING_RETRYStep is waiting for retry
Step input as JSON
Step output as JSON (if completed)
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
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
}