Skip to main content
The executor can fail before execution, during validation, or while running providers and tools.

​
Error phases

PhaseExample
Parsemalformed block syntax
Validationunknown reference or invalid schema path
Runtimeprovider request failed, tool call failed, invalid model output

​
/execute error shape

{
  "error": {
    "kind": "validation_error",
    "message": "Unknown reference: agent.missing.summary",
    "issues": [
      {
        "path": "agent.writer.instruction",
        "message": "Unknown reference: agent.missing.summary"
      }
    ]
  }
}

​
/execute event-stream error shape

event: workflow_failed
data: {"message":"Provider request failed"}

​
Common fixes

  • Check that every referenced agent field exists in that agent’s output block.
  • Check that input and secrets payloads match the workflow declarations.
  • Check that imported tools, prompts, and resources are listed in an agent’s uses array when the agent needs them.
  • Check provider endpoint, API key, and model IDs.
  • Check that tool call runtime values are supplied with bindings {}.