Request Tracing
| Header | Type | Description |
|---|---|---|
X-Request-ID | string | Unique request identifier for debugging and support. Include this in support requests for fast resolution. |
Rate Limiting
| Header | Type | Description |
|---|---|---|
Retry-After | integer | Seconds until rate limit resets. Standard HTTP header for retry backoff. |
X-RateLimit-Limit-Requests | integer | Request limit per window |
X-RateLimit-Remaining-Requests | integer | Remaining requests in window |
X-RateLimit-Reset-Requests | string | When limit resets (ISO 8601 format) |
Billing & Credits
| Header | Type | Description |
|---|---|---|
X-Credits-Balance-Microdollars | integer | Current workspace credit balance in microdollars (1 USD = 1,000,000) |
Budget
| Header | Type | Description |
|---|---|---|
X-Budget-Daily-Limit | string | Daily budget limit in USD |
X-Budget-Daily-Spend | string | Daily budget spend in USD (present when daily budget exists) |
X-Budget-Exceeded | string | Whether a budget limit was exceeded |
X-Budget-Exceeded-Period | string | Period of the exceeded budget (daily, weekly, or monthly) |
X-Budget-Exceeded-Scope | string | Scope of the exceeded budget (workspace, api_key, or byok_provider) |
X-Budget-Monthly-Limit | string | Monthly budget limit in USD |
X-Budget-Monthly-Spend | string | Monthly budget spend in USD (present when monthly budget exists) |
X-Budget-Weekly-Limit | string | Weekly budget limit in USD |
X-Budget-Weekly-Spend | string | Weekly budget spend in USD (present when weekly budget exists) |
Error Diagnostics
| Header | Type | Description |
|---|---|---|
X-Error-Provider | string | Which provider produced the error |
X-Error-Retryable | string | Whether the client should retry this request. ‘true’ for server_error and rate_limit types; ‘false’ for all others. |
X-Error-Type | string | Normalized error category for programmatic retry/routing decisions. Auriko-level errors produce one of the enum values below. Provider errors (ProviderError, ProviderTimeout) may use additional LLMErrorType values (e.g., timeout, authentication, content_filter). |