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

# MISSING_SCOPE

> The API key lacks a scope this endpoint needs.

`403 Forbidden` · type `permission`

**When it happens**

The endpoint needs a scope the key wasn't given, for example `quotes:write` to create a quote. The message names the missing scopes.

**What to do**

Scopes are set when a key is created. Ask an agency admin to create a key with the scopes you need, then revoke the old one. See [scopes](/authentication#scopes).

## Example

```json 403 Forbidden theme={null}
{
  "error": {
    "type": "permission",
    "code": "MISSING_SCOPE",
    "message": "This API key is missing the required scope(s): quotes:write.",
    "doc_url": "https://docs.bridgelinepf.com/errors#MISSING_SCOPE",
    "request_id": "req_8fJ2kQ9xLm4TzW7nB3cY5pDv"
  }
}
```

See all [error codes](/errors), or how to [handle errors](/guides/errors).


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