{"version":"v1","as_of":"2026-04-21T14:58:05.481Z","data":{"errors":[{"code":"BAD_REQUEST","http_status":400,"retryable":false,"category":"request","meaning":"Payload or query parameters are invalid.","next_action":"Validate request fields against OpenAPI schema and retry."},{"code":"UNAUTHORIZED","http_status":401,"retryable":false,"category":"auth","meaning":"Missing or invalid API key.","next_action":"Provide x-api-key or valid bearer token and retry."},{"code":"FORBIDDEN","http_status":403,"retryable":false,"category":"authz","meaning":"Authenticated key lacks the required scope.","next_action":"Use a key with the required scope for this endpoint."},{"code":"INSUFFICIENT_PREPAID_BALANCE","http_status":402,"retryable":true,"category":"billing","meaning":"Prepaid balance is required for non-billing endpoints.","next_action":"Top up via /api/v1/billing/topups/charge (or /topups/checkout), then retry original call."},{"code":"BILLING_LIMIT_EXCEEDED","http_status":402,"retryable":false,"category":"billing","meaning":"Configured monthly spend cap was reached.","next_action":"Increase cap or use a different key with available budget."},{"code":"PAYMENT_FAILED","http_status":402,"retryable":true,"category":"billing","meaning":"Direct top-up charge failed at payment processor.","next_action":"Retry with a valid payment method or complete hosted checkout."},{"code":"RATE_LIMITED","http_status":429,"retryable":true,"category":"throttle","meaning":"Per-minute request limit exceeded.","next_action":"Back off until x-ratelimit-reset, then retry with jitter."},{"code":"AGENT_AUTH_NOT_CONFIGURED","http_status":503,"retryable":false,"category":"platform","meaning":"Agent key configuration is unavailable on server.","next_action":"Contact provider support."},{"code":"PAYMENT_LINKS_UNAVAILABLE","http_status":503,"retryable":true,"category":"billing","meaning":"Hosted payment links are not currently configured.","next_action":"Use direct charge flow or retry later."}],"guidance":{"retry_policy":{"on_429":"exponential_backoff_with_jitter","on_402_retryable":"resolve_billing_then_retry","on_5xx":"bounded_retries"},"reference":"/docs/api/openapi.v1.yaml"}}}