Errors - Onstacks

Errors use the same envelope structure as successful responses.

{
  "data": null,
  "error": {
    "code": "validation_error",
    "message": "Request payload is invalid",
    "details": {}
  },
  "request_id": "req_..."
}

Common status codes

Status	Meaning
`400`	The request payload, path parameter, or query parameter is invalid.
`401`	The caller is not authenticated or the session is invalid.
`404`	The requested resource does not exist in the current workspace or environment.

Request IDs

Include request_id when you report API issues.

Authentication failures

Protected routes require a workspace API key in Authorization: Bearer <api_key>.

Environment mistakes

Environment-scoped routes default to sandbox. always pass environment=live explicitly when operating on live workspace resources.