GET
/workflows.stepFailedSubmit workflow step failure
Submits a failure notification for an app's workflow step execution. Identify the execution with workflow_step_execute_id and provide error as a JSON-based object containing a human-readable message property.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
workflow_step_execute_idstringrequired
The context identifier that maps the request to the workflow step execution being marked as failed.
errorstringrequired
A JSON-encoded error object containing a `message` property with a human-readable explanation of the failure.
tokenstringrequired
The authentication token used to authorize the request; this operation requires the `workflow.steps:execute` scope.
200Returns a success response containing `ok: true`.
okbooleanrequired
defaultReturned when the request cannot be processed and the response contains `ok: false`.
okbooleanrequired
Error handling
workflow_step_execute_id and error must both be provided, and error must be a JSON-based object with a human-readable message property. token must use the workflow.steps:execute scope.