> ## Documentation Index
> Fetch the complete documentation index at: https://docs.api.rask.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# token_spend_limit_exceeded

> Token spend limit exceeded: HTTP 403 from the Rask API v3. What it means, what to do and which operations return it.

| Status | `retry` | `recommendation` |
| - | - | - |
| 403 | `none` | `fix_request` |

## What happened

Token spend limit exceeded. For example: This request would exceed the key's monthly limit on the minutes pool.

## What to do

Stop until resets\_at, or ask the user to raise this key's monthly limit in Settings -> API keys.

`fix_request`: change the request or its inputs; sent unchanged it fails again.

`none`: do not retry the request unchanged.

## Example

```json theme={null}
{
  "type": "https://docs.api.rask.ai/errors/token_spend_limit_exceeded",
  "title": "Token spend limit exceeded",
  "status": 403,
  "detail": "This request would exceed the key's monthly limit on the minutes pool.",
  "instance": "urn:uuid:7d5c0e9a-3f1b-4c2e-9a8d-6b4f2e1c0d93",
  "code": "token_spend_limit_exceeded",
  "retryable": false,
  "retry": "none",
  "recommendation": "fix_request",
  "hint": "Stop until resets_at, or ask the user to raise this key's monthly limit in Settings -> API keys.",
  "errors": [],
  "credit_type": "minutes",
  "limit_minutes": 500,
  "spent_minutes": 495,
  "required_minutes": 12,
  "resets_at": "2026-12-01T00:00:00Z"
}
```

## Inside a job

It also appears inside a job, as `Job.error` or `Job.stages[].error`, on jobs of type `localization`.

| Status | `retry` | `recommendation` |
| - | - | - |
| 403 | `new_key` | `fix_request` |

Wait for the key's limit to reset or ask the user to raise it, then call resumeJob with the total\_minutes of estimateLocalization.

## Operations that return it

* [createDub](https://docs.api.rask.ai/operations/createDub.md)
* [createLipsync](https://docs.api.rask.ai/operations/createLipsync.md)
* [createLocalization](https://docs.api.rask.ai/operations/createLocalization.md)
* [createOnscreen](https://docs.api.rask.ai/operations/createOnscreen.md)
* [createProject](https://docs.api.rask.ai/operations/createProject.md)
* [createProjectCopies](https://docs.api.rask.ai/operations/createProjectCopies.md)
* [generateSegments](https://docs.api.rask.ai/operations/generateSegments.md)
* [resumeJob](https://docs.api.rask.ai/operations/resumeJob.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.