Errors

Error shape

Errors are returned as JSON with a consistent shape:

{
  "status": 400,
  "message": "Validation failed",
  "errors": [{ "path": ["email"], "message": "Invalid email address" }]
}

The top-level errors array (Zod validation issues) is only present on 400 validation errors.

Status	Meaning
`400`	Validation error — request body/query failed schema validation
`401`	Authentication error — missing or invalid API key/session
`403`	Permission error — authenticated, but not authorized for this workspace/resource
`404`	Not found
`409`	Conflict — e.g. duplicate slug, stale update
`429`	Rate limited — see Rate Limits
`500`	Server error

Auth errors never reveal whether a resource or account exists — expect a generic message on 401/403 rather than a detailed reason.