BioFlow / API docs / Errors / insufficient_scope

`insufficient_scope`

HTTP 403application/problem+json

The API key was not granted the required scope.

Open in Claude ↗Open in ChatGPT ↗

What causes it

The API key was created without the scope this operation requires (each operation's docs 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.

Wire format

Example response body.

{
  "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 always resolves to this page. Quote request_id when contacting support. Full code registry on the API docs hub; the complete surface is in the interactive reference.