> ## 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.

# insufficient_balance

> Insufficient balance: HTTP 402 from the Rask API v3. What it means, what to do and which operations return it.

| Status | `retry` | `recommendation` |
| - | - | - |
| 402 | `none` | `top_up` |

## What happened

Insufficient balance. For example: Dubbing project 6f1c2b7e needs 1 minute; the workspace owner has 0.

## What to do

Stop and tell the user: the workspace owner adds minutes in the web app. Check GET /v3/balance.

`top_up`: the workspace owner adds minutes or changes the plan in the web app.

`none`: do not retry the request unchanged.

## Example

```json theme={null}
{
  "type": "https://docs.api.rask.ai/errors/insufficient_balance",
  "title": "Insufficient balance",
  "status": 402,
  "detail": "Dubbing project 6f1c2b7e needs 1 minute; the workspace owner has 0.",
  "instance": "urn:uuid:7d5c0e9a-3f1b-4c2e-9a8d-6b4f2e1c0d93",
  "code": "insufficient_balance",
  "retryable": false,
  "retry": "none",
  "recommendation": "top_up",
  "hint": "Stop and tell the user: the workspace owner adds minutes in the web app. Check GET /v3/balance.",
  "errors": [],
  "credit_type": "minutes",
  "required_minutes": 1,
  "balance_minutes": 0
}
```

## Inside a job

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

| Status | `retry` | `recommendation` |
| - | - | - |
| 402 | `new_key` | `top_up` |

Stop and tell the user: the workspace owner adds minutes in the web app. Check GET /v3/balance.

## 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.