Error handling - Temporal Nexus
SUPPORT, STABILITY, and DEPENDENCY INFO
Temporal Nexus is now Generally Available for Temporal Cloud and self-hosted deployments.
Nexus Operations can return errors for a caller Workflow to handle. Errors from an asynchronous Operation's underlying Workflow propagate back to the caller.
Errors in Nexus handlers
Nexus handlers may return different error types. By default, handler errors are retryable unless they are:
- Application Failures marked as non-retryable.
- Unsuccessful Operation errors that resolve an Operation as failed or canceled.
- Non-retryable Nexus errors.
When the caller's Nexus Machinery receives an error:
- Non-retryable - A NexusOperationFailed event is added to the caller's Workflow History.
- Retryable - The Nexus Machinery automatically retries. These errors surface in Pending Operations.
tip
Return a specific Nexus error type to avoid infinite retries. See errors in Nexus Operations for additional details.
Nexus error handling in caller Workflows
When a Nexus Operation fails, the caller receives a Nexus Operation Failure containing the Operation name, token, and failure reason. The underlying cause is typically an Application Error or Canceled Error.