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

> Insufficient scope: 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

Insufficient scope. For example: This operation needs scopes the key does not have.

## What to do

Use a key that has the scopes in required\_scopes; scopes cannot be added to an existing key.

`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/insufficient_scope",
  "title": "Insufficient scope",
  "status": 403,
  "detail": "This operation needs scopes the key does not have.",
  "instance": "urn:uuid:7d5c0e9a-3f1b-4c2e-9a8d-6b4f2e1c0d93",
  "code": "insufficient_scope",
  "retryable": false,
  "retry": "none",
  "recommendation": "fix_request",
  "hint": "Use a key that has the scopes in required_scopes; scopes cannot be added to an existing key.",
  "errors": [],
  "required_scopes": [
    "dubbing:write",
    "credits:spend"
  ],
  "granted_scopes": [
    "dubbing:write",
    "projects:read",
    "jobs:read"
  ]
}
```

## Operations that return it

Most operations: 81 of 82 declare it. The reference page of each operation lists its errors.


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