Configuring Timeout — HIL Timeout

Node Configuration Fields

Field	Type	Required	Default
`timeoutDuration`	ISO 8601 string	No	null (no timeout)
`timeoutBehavior`	enum	If duration set	Fail
`escalationActorId`	string	If behavior = Escalate	null
`escalationDuration`	ISO 8601 string	No	Same as timeoutDuration

ISO 8601 Duration Reference

Format	Duration
`PT15M`	15 minutes
`PT1H`	1 hour
`PT4H`	4 hours
`PT8H`	8 hours (one working day)
`P1D`	1 day (24 hours)
`P2D`	2 days
`P1W`	7 days

Configuration Examples

// Auto-reject after 1 business day
{
  "timeoutDuration" : "PT8H",
  "timeoutBehavior" : "AutoReject"
}

// Escalate to manager after 4 hours; give manager 8 more hours
{
  "timeoutDuration"    : "PT4H",
  "timeoutBehavior"    : "Escalate",
  "escalationActorId"  : "$output.getManagerNode.managerId",
  "escalationDuration" : "PT8H"
}

// No timeout — wait indefinitely (use only for archival/long-running workflows)
{
  "timeoutDuration" : null
}

Validation Rules

If timeoutBehavior = "Escalate", then escalationActorId is required.
If timeoutBehavior = "Escalate" or "AutoApprove"/"AutoReject", the node must have the corresponding output port connected — unconnected ports that could fire are flagged as design warnings.
A zero-duration timeout (PT0S) is rejected at design time.

← Overview Next: The Timeout Background Job →