Errors

All errors return a standard JSON envelope with an appropriate HTTP status code:

{
  "success": false,
  "error": "Human-readable error message"
}

HTTP status codes

Code	Meaning	Common causes
`400`	Bad Request	Invalid `template`, invalid `blocks` (bad JSON, unknown block types, empty array), malformed UUID in path
`401`	Unauthorized	Missing `X-API-KEY` header, invalid or revoked API key
`404`	Not Found	Run, canvas, or task does not exist or belongs to another account
`500`	Internal Error	Unexpected server error — details are logged server-side and not exposed to callers

{
  "success": false,
  "error": "Invalid template: foo. Valid templates: app, auto, deep_research, excel, landing_page, memo, report, slides"
}

{
  "success": false,
  "error": "Invalid block types: my-block. Valid block types: app-block, deep-research-block, ..."
}

{
  "success": false,
  "error": "X-API-KEY header required"
}

{
  "success": false,
  "error": "Run not found: 550e8400-e29b-41d4-a716-446655440000"
}

{
  "success": false,
  "error": "Invalid run_id: must be a valid UUID"
}

{
  "success": false,
  "error": "An internal error occurred while creating the run"
}