Skip to main content

Errors

This reference lists possible Workflow Task errors and how to resolve them.

For other types of errors, see Temporal Failures.

Each of the below errors corresponds with a WorkflowTaskFailedCause, which appears in Events under workflow_task_failed_event_attributes.

Bad Cancel Timer Attributes​

This error indicates that the Workflow Task failed while attempting to cancel a TimerLink preview iconWhat is a Timer?

A Timer lets a Workflow sleep for a fixed time period.

Learn more.

Check your Timer attributes for a missing Timer Id value. Add a valid Timer Id and redeploy the code.

Bad Cancel Workflow Execution Attributes​

The Workflow Task failed due to unset CancelWorkflowExecution attributes.

Reset any missing attributes and redeploy the Workflow Task.

Bad Complete Workflow Execution Attributes​

This error indicates that the Workflow Task failed due to unset attributes on CompleteWorkflowExecution.

Reset any missing attributes. Adjust the size of your Payload if it exceeds size limits.

Bad Continue as New Attributes​

This error indicates that the Workflow Task failed to validate a ContinueAsNew attribute. The attribute could be unset or invalid.

Reset any missing attributes. If the payload or memo exceeded size limits, adjust the input size.

Check that the Workflow is validating search attributes after unaliasing keys.

Bad Fail Workflow Execution Attributes​

This error indicates that the Workflow Task failed due to unset FailWorkflowExecution attributes.

If you encounter this error, make sure that StartToClostTimeout or ScheduleToCloseTimeout are set. Restart the Worker that the Workflow and Activity are registered to.

Bad Modify Workflow Properties Attributes​

This error indicastes that the Workflow Task failed to validate attributes on a property in the Upsert Memo or in a payload. These attributes are either unset or exceeding size limits.

Reset any unset and empty atrributes. Adjust the size of the Memo or payload to fit within the system's limits.

Bad Record Marker Attributes​

This error indicates that the Workflow Task failed due to an unset or incorrect Marker name.

Enter a valid Marker name and redeploy the Task.

Bad Request Cancel Activity Attributes​

This error either indicates the possibility of unset attributes for RequestCancelActivity, or an invalid History Builder state.

Update the Temporal SDK to the most recent release. Reset any unset attributes before retrying the Workflow Task.

If you continue to see this error, review your code for nondeterministic causes.

Bad Request Cancel External Workflow Execution​

This error indicates that the Workflow Task failed while trying to cancel an external Workflow. Unset or invalid attributes can cause this to occur.

Reset any missing attributes, such as Workflow Id or Run Id. Adjust any fields that exceed length limits.

If a Child Workflow is set to Start and RequestCancel, remove one of these attributes. A Child Workflow cannot perform both actions in the same Workflow Task.

Bad Schedule Activity Attributes​

This error indicates unset or invalid attributes for ScheduleActivityTask or CompleteWorkflowExecution.

Reset any unset or empty attributes. Adjust the size of the received payload to stay within the given size limit.

Bad Search Attributes​

This error indicates that the Workflow Task has unset or invalid Search AttributesLink preview iconHow to use Search Attributes

Search Attributes enable complex List Filters to find the exact of Workflow Executions you are looking for.

Learn more. This can cause Workflow Tasks to continue to retry without success.

Make sure that all attributes are defined before retrying the Task. Adjust the size of the Payload to fit within the system's size limits.

Bad Signal Input Size​

This error indicates that the Payload has exceeded the Signal's available input size.

Adjust the size of the Payload, and redeploy the Workflow Task.

Bad Signal Workflow Execution Attributes​

This error indicates that the Workflow Task failed to validate attributes for SignalExternalWorkflowExecution.

Reset any unset, missing, nil, or invalid attributes. Adjust the input to fit within the system's size limits.

Bad Start Child Execution Attributes​

This error indicates that the Workflow Task failed to validate attributes for StartChildWorkflowExecution

Adjust the input size of the attributes to fall within the system's size limits.

Make sure that Search AttributeLink preview iconHow to use Search Attributes

Search Attributes enable complex List Filters to find the exact of Workflow Executions you are looking for.

Learn more validation is performed after unaliasing keys.

Bad Start Timer Attributes​

This error indicates that the scheduled Event is missing a Timer IdLink preview iconWhat is a Timer?

A Timer lets a Workflow sleep for a fixed time period.

Learn more.

Set a valid Timer Id and retry the Workflow Task.

Cause Bad Binary​

This error indicates that the Worker deployment returned a bad binary checksum.

Cause Reset Workflow​

This error indicates that the Workflow Task failed due to a request to reset the Workflow.

If the system hasn't started a new Workflow, manually reset the Workflow.

Cause Unspecified​

This error indicates that the Workflow Task has failed for an unknown reason.

If you see this error, contact your administrator to file a support ticket or report it here.

Failover Close Command​

This error indicates that a Namespace failover forced the Workflow Task to close. The system automatically schedules a retry when this error occurs.

Force Close Command​

This error indicates that the Workflow Task was forced to close. A retry will be scheduled if the error is recoverable.

Non-Deterministic Error​

The Workflow Task failed due to a nondeterministic error.

Pending Activities Limit Exceeded​

The Workflow has reached capacity for pending Activities. Therefore, the Workflow Task was failed to prevent the creation of another Activity.

Let the Workflow complete any current Activities before redeploying the code.

Pending Child Workflows Limit Exceeded​

This error indicates that the Workflow has reached capacity for pending Child Workflows. Therefore, the Workflow Taskwas failed to prevent additional Child Workflows from being added.

Wait for the system to finish any currently running Child Workflows before redploying this Task.

Pending Request Cancel Limit Exceeded​

This error indicates that the Workflow Task failed after attempting to add more cancel requests. The Workflow has reached capacity for pending requests to cancel other Workflows, and cannot accept more requests.

If you see this error, give the system time to process pending requests before retrying the Task.

Pending Signals Limit Exceeded​

The Workflow has reached capacity for pending Signals. Therefore, the Workflow Task was failed after attempting to add more Signals to an external Workflow.

Wait for Signals to be processed by the Workflow before retrying the Task.

Reset Sticky Task Queue​

This error indicates that the Sticky Task Queueneeds to be reset.

If you see this error, reset the Sticky Task Queue. The system will retry automatically.

Resource Exhausted Cause Concurrent Limit​

This error indicates that the concurrent poller count has been reached.

Adjust the poller count per Worker.

Resource Exhausted Cause Persistence Limit​

This error indicates that the persistence rate limit has been reached.

Resource Exhausted Cause RPS Limit​

This error indicates that the Workflow has reached its RPS limit.

Resource Exhausted Cause System Overload​

This error indicates that the system is overloaded and cannot allocate further resources to Workflow Tasks.

Resource Exhausted Cause Unspecified​

This error indicates that an unknown cause is preventing resources from being allocated to further Workflow Tasks.

Schedule Activity Duplicate Id​

The Workflow Task failed because the Activity Id is already in use.

Check your code to see if you've already specified the same Activity Id in your Workflow. Enter another Activity Id, and try running the Workflow Task again.

Start Timer Duplicate Id​

This error indicates that a TimerLink preview iconWhat is a Timer?

A Timer lets a Workflow sleep for a fixed time period.

Learn more with the given Timer Id has already started.

Try entering a different Timer Id, and retry the Workflow Task.

Unhandled Command​

This error indicates new available Events since the last Workflow Task started. The Workflow Task was failed because the Workflow attempted to close itself without handling the new Events.

UnhandledCommand can happen when the Workflow is receiving a high number of Signals. If the Workflow doesn't have enough time to handle these Signals, a RetryWorkflow Task is scheduled to handle these new Events.

To prevent this error, drain the Signal Channel with the ReceiveAsync function.

If you continue to see this error, check your logs for failing Workflow Tasks. The Workflow may have been picked up by a different Worker.

Workflow Worker Unhandled Failure​

This error indicates that the Workflow Task encountered an unhandled failure from the Workflow Definition.