Errors

The API returns structured errors with a stable code, a human-readable message, and a request_id for support.

Shape

Errors are JSON objects: { type, code, message, request_id, details? }. The HTTP status code is always set appropriately.

Common codes

validation_error · authentication_failed · permission_denied · resource_not_found · rate_limited · upstream_unavailable.