Skip to main content
POST
Analyze a failed workflow run

Authorizations

api_key
string
header
required

Personal API key.

Path Parameters

app_id
string
required

ID of the app whose workflows you want to work with.

workflow_id
string
required

ID of the workflow, as returned in id by List workflows.

run_id
string
required

ID of the run, as returned in run_id by List runs for a workflow.

Response

The explanation. Check that it is non-empty.

AI-generated failure analysis.

explanation
string
required

Why the run failed, in plain language. Empty when the model could not be reached.

Example:

"The email step failed because the recipient address was missing from the trigger payload."

generated_at
string
required

When the explanation was produced, as an ISO 8601 timestamp. Empty when none was produced.

Example:

"2026-08-25T09:20:11Z"