← API reference
CANONICAL TYPE REFERENCE

WorkflowNodeDefinition

A node (step) in a workflow

Per-node execution timeout in seconds; when omitted, the engine uses the workflow timeout policy

Maximum retry count for this node; when omitted, the engine uses its default retry policy

Whether the engine may continue scheduling the workflow after this node fails

idString!

Node identifier (unique within workflow)

nameString!

Node display name

Which kind of node this is. Selects the node's behaviour and, with it, the shape its config must take.

Node configuration, as the JSON object described by this node type's config schema. Null when the node takes no configuration.

Visual position in workflow diagram

View exact SDL
"""A node (step) in a workflow"""
type WorkflowNodeDefinition {
  """
  Per-node execution timeout in seconds; when omitted, the engine uses the workflow timeout policy
  """
  timeoutSeconds: Float
  """
  Maximum retry count for this node; when omitted, the engine uses its default retry policy
  """
  maxRetries: Int
  """
  Whether the engine may continue scheduling the workflow after this node fails
  """
  continueOnError: Boolean
  """Node identifier (unique within workflow)"""
  id: String!
  """Node display name"""
  name: String!
  """
  Which kind of node this is. Selects the node's behaviour and, with it, the shape its config must take.
  """
  type: WorkflowNodeType!
  """
  Node configuration, as the JSON object described by this node type's config schema. Null when the node takes no configuration.
  """
  config: WorkflowNodeConfigJSONScalar
  """Visual position in workflow diagram"""
  position: WorkflowNodePosition
}

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