← All types
Ob Object

WorkflowExecutionState

A single execution instance of a workflow

Fields

Unique identifier

Tenant ID

Workflow ID being executed

Workflow name at query time (optional)

Workflow version ID being executed

Current execution status

Possible values (6)
PENDING

Execution is queued but not yet started

RUNNING

Execution is currently in progress

COMPLETED

Execution completed successfully

FAILED

Execution failed with an error

WAITING

Execution is waiting for an external signal (e.g., human task)

CANCELLED

Execution was cancelled

Whether cancellation has been requested but not yet finalized

How the execution was triggered

Possible values (8)
MANUAL

Manually triggered by a user

SCHEDULED

Triggered by a schedule

EVENT

Triggered by a data change event

DEVICE_MQTT

Triggered by a device MQTT publish

WEBHOOK

Triggered by an external webhook

SCRIPT

Triggered by a script

EDGE_APP_EVENT

Triggered by an edge app event

FOLDER_WATCH

Triggered by a folder watch

input

String!Non-null

Input variables as JSON

output

StringNullable

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)

totalWaves

Int!Non-null

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.

Referenced by (6)
Exact type 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
}