# insufficient_scope

The API key was not granted the required scope. What causes the BioFlow API's insufficient_scope error (HTTP 403) and how to fix it.

HTTP 403 · `application/problem+json` · The API key was not granted the required scope.

## What causes it

- The API key was created without the scope this operation requires (each operation's reference page lists its required scope).

## How to fix it

- Create a key with the needed scope in the developer console, or widen the existing key's scopes and retry.

## Example response body

```json
{
  "type": "https://getbioflow.com/docs/api/errors/insufficient-scope",
  "title": "The API key was not granted the required scope",
  "status": 403,
  "instance": "urn:request:req_01abc",
  "code": "insufficient_scope",
  "request_id": "req_01abc"
}
```

Branch on the stable `code` field — `title` and `detail` are for humans and may
change. `type` (`https://getbioflow.com/docs/api/errors/insufficient-scope`) always resolves to this page. Quote
`request_id` when contacting support. Full code registry on the
[API docs hub](/docs/api#errors); the complete surface is in the
[interactive reference](/docs/api-reference).