A Workday Orchestrate run can show a success-looking status while steps in it did not do their work, because Workday does not count an unsuccessful HTTP response as a failure unless you define an HTTP retry policy with a success range, and an error handler set to Conditional Outputs lets the run continue past an error. To find the step, open the run’s activity, read the per-process stepsFailed, then check the logs for the step name.
The statuses and component behaviour below are from Workday’s Orchestrate documentation. Workday does not publish the text of every runtime error, so this page quotes only the statuses, settings and messages the documentation names.
What statuses can an orchestration run have?
Orchestration Activity, on an app’s page of the Developer Site, lists these for a run:
| Status | Documented meaning |
|---|---|
StatusRUNNING |
Documented meaningIn progress. |
StatusAWAITING_CALLBACK |
Documented meaningPaused, waiting for an external callback. |
StatusSUCCESS |
Documented meaningCompleted successfully. |
StatusCANCELLED |
Documented meaningCancelled before completion, at the next safe cancellation checkpoint. |
StatusKILLED |
Documented meaningKilled before completion, immediately. |
StatusCOMPLETED_WITH_ERROR |
Documented meaning“The orchestration completed but encountered processing errors.” |
StatusQUEUED |
Documented meaningWaiting to be executed. |
StatusTIMED_OUT |
Documented meaningDid not complete in the expected time. |
StatusFAILED |
Documented meaningFailed to complete successfully. |
The Insights API reports the same states plus FAILED_NOT_EXECUTED, for an orchestration that failed to launch. In the Orchestration Activity summary bar, green is Completed, yellow is Completed with errors, red is Failed, timed out or cancelled, and blue is running or awaiting callback. A yellow run finished, and Workday flags that it hit processing errors. Start there before trusting green.
Why does the run show success when an HTTP call returned an error?
Because the step did not fail. The Define HTTP Retry Policies page says that to make an unsuccessful HTTP response fail your orchestration you must create a custom HTTP retry policy with a defined success range, and that “in the absence of such a policy, an unsuccessful HTTP response doesn’t cause an orchestration to fail.”
So a Send Workday API Request or Send HTTP Request step that gets a 400 or 500 back completes, the orchestration moves on, and nothing marks it failed. The same applies to calls made inside sub-orchestrations, which is why they report Completed (sub-orchestrations that show Completed when an API call fails).
The fix is on the step:
- In Orchestration Settings, open HTTP Retries and create a policy.
- Under Successful Response Code Ranges, add the range you accept, for example 200 to 299.
- Set Maximum Total Retries (up to 60) and a backoff, or set retries low if the call must not repeat.
- On the step’s Settings tab, in Retry Settings, select the policy. It is available on Send HTTP Request, Send WWS Pagination API Request and Send Workday API Request.
For SOAP, the isSoapFault function returns true when a document is XML and contains a SOAP 1.1 or 1.2 Fault, so a SOAP fault can be tested for explicitly.
Why did the run continue after a step failed?
Probably an error handler. Orchestration Builder lets you attach a local error handler to a step or group of steps, and a global one for anything not caught locally. The handler has two modes:
- Propagate Error runs the handler’s steps and rethrows the error to the parent handler, or the global handler if there is none. The run then fails.
- Conditional Outputs runs the handler’s steps and outputs a boolean
isSuccess.truemeans the guarded step worked and its outputs are available downstream.falsemeans onlyisSuccessis available. The run carries on.
A handler in Conditional Outputs mode that does nothing but continue is a step that failed with the run still going. Check each handler for what it does with isSuccess = false. Also note what Workday says about downstream steps: if they read the primary outputs of a failed step without checking isSuccess, Orchestration Builder rethrows the error.
The handler cannot read the failing step’s exception message. It starts with the same data the step began with, plus a processingError output. Add a Log step in the handler and write the message or locationPath member function of processingError. message returns the error text with the error type in front and the qualified step ID at the end; locationId returns the step’s ID. Workday says the message is for logging only, so don’t branch on its text.
Can a sub-orchestration hide the failure from the parent?
Yes. Workday’s modular design guidance describes two choices in a sub-orchestration: propagate the error so the sub-orchestration’s global handler or the parent marks the run failed, or handle it locally and set outputs that describe the failure. With the second, the parent’s Call step finishes normally. The guidance is to never assume the call succeeded: expose a small set of fields the parent can always rely on, such as status, errorSummary and errorDetails, and branch on status before using the outputs.
What does Continue on Conditions do when its test is false?
If the assertion evaluates to true the orchestration continues. If false, per the reference, “the orchestration stops and Orchestration Builder logs the specified message.” Put a clear message in each assertion. It is the text you will search for in the logs.
How do I find which step failed?
- Orchestration Activity. Open the orchestration, find the run, and expand Current Status to reach its logs with the run’s filter applied. Note the Run ID, the Common Request ID and the Process IDs.
- Insights API.
GET /reporting/v1.1/apps/{appId}/orchestrations/{orchName}/runs/{runId}returns the run withcomputeDuration,elapsedDurationand, for each process,stepsSuccessfulandstepsFailed. Event data is kept for 29 days. - Logs. In Orchestration Builder, Run Logs (and API Logs) show the run on the tenant. Useful fields:
wd_orch_name,wd_orch_step_name,wd_response_code,wd_pathandwd_message. Filterwd_leveltoERRORandWARN. Workday deletes logs older than 30 days. - Orchestration Summary Report. Generate it from the Orchestration Activity tab; it is a JSON file with
successCountandfailureCountfor each step in each process. - Step debugger. Run the step with its recorded inputs. Debugging is unavailable for Trigger Business Process, Trigger Integration, Trigger PDF Generation and Send HTTP Request steps that use polling. An orchestration built on the Integration System template, or one with certain components such as Store Document, Log to File or Add Integration Message in a sub-orchestration, must be deployed to a tenant and run once before you can debug it.
Worked example: an update loop that reports success
An Integration System orchestration reads three workers from a report and, in a loop, sends one Send Workday API Request per worker to update an email address. Logan McNeil’s request is rejected with a 400 because the new value is invalid; the other two succeed. The run ends and the team sees green.
- Open Orchestration Activity. Nothing in the status points at the 400: the step itself completed.
- In the logs, filter
wd_response_codeto 400 andwd_orch_step_nameto the update step. One entry appears, for Logan McNeil’s request. - Cause: the step has no HTTP retry policy with a success range, so the 400 was accepted as a completed step.
- Fix: create a policy with a success range of 200 to 299 and select it in the step’s Retry Settings. Add an Add Integration Message step (Integration System template) with severity
ERRORand a condition for the failing case, so the failure is written to the integration event in the tenant. - Re-run the same three workers. The run now fails, or goes to your error handler, on Logan McNeil’s request, and the other two are the proof the good path still works.
What do I check before calling it fixed?
Run the affected path again with a record that is known to fail and one known to pass, read the status in Orchestration Activity, read stepsFailed in the Insights API, and read the destination record back. A quiet log or a green run proves the run finished, not that the work happened. If the failure is a timeout rather than a status problem, see keeping large loads inside the runtime limits, and for where each logging step writes, see logging in Orchestrate.
Frequently asked questions
Does an HTTP 400 or 500 response fail a Workday orchestration?
Not by default. Workday states that without a custom HTTP retry policy that defines a successful response code range, an unsuccessful HTTP response does not cause the orchestration to fail. Define a policy with a success range such as 200 to 299 on the step.
What are the run statuses in Orchestration Activity?
RUNNING, AWAITING_CALLBACK, SUCCESS, CANCELLED, KILLED, COMPLETED_WITH_ERROR, QUEUED, TIMED_OUT and FAILED. The Insights API adds FAILED_NOT_EXECUTED for a run that failed to launch.
Where do I see how many steps failed in a run?
The Insights API run detail returns, for each process, stepsSuccessful and stepsFailed. The Orchestration Summary Report gives successCount and failureCount per step.
Can the error handler read the failing step's error message?
Not directly. The handler cannot read the failing step's exception message, but it receives a processingError output with the error's location, and you can write the message out with the Log component. Workday says not to base logic on the message text.
Why can't I debug the failing step in Orchestration Builder?
Debugging is unavailable for Trigger Business Process, Trigger Integration, Trigger PDF Generation and Send HTTP Request steps that use polling. Integration System orchestrations must be deployed and run once on a tenant first.