{"version":"2.1.292","anchor":"api-error-carries-rate-limit-info-for-usage-limit-reached","canonical_anchor":"api-error-carries-rate-limit-info-for-usage-limit-reached","heading":"Usage-limit errors in the SDK now say when the limit resets","tier":"use","area":"SDK","scope":"individual","heads_up":false,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.292\/e\/api-error-carries-rate-limit-info-for-usage-limit-reached","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.292","markdown":"### Usage-limit errors in the SDK now say when the limit resets\n\nSDK api_error messages can now carry rate_limit_info describing the limit that refused the request, including when it resets\n\n**What**\n\nWhen the API refuses a request because a usage limit was reached, the `api_error` in the SDK can now carry an optional `rate_limit_info` field. The SDK is the Agent SDK, which lets programs run Claude Code. The field has the same shape as `rate_limit_event` and describes the limit that refused the request:\n\n- `status`\n\n- `type`\n\n- `resetsAt`\n\n- overage fields\n\n**Why**\n\nPrograms can show a user when the limit resets without having to pick that out of the error message text.\n\n- Area: SDK\n- Names: `rate_limit_info`, `api_error`, `rate_limit_event`\n- Tier: Use it now\n- Useful: 4\/5\n- Signal: 1\/5\n- Scope: individual\n- Heads-up: no"}