403 Insufficient scope

The key is valid but was not granted a scope this endpoint requires. The `detail` field names exactly which scopes are missing.

Retry only after changing the request

What causes it

• The key was minted with a narrower scope set than the integration ended up needing.
• A new endpoint was added to your integration without widening the key.

How to fix it

• Read the missing scopes out of `detail`, then mint a key that includes them. Scopes are fixed at mint time and cannot be added to an existing key.
• Prefer one key per integration over one broad shared key: it keeps the blast radius of a leak small, and the rate limit is per key.

Example response

HTTP/1.1 403
Content-Type: application/problem+json

{
  "type": "https://sealdeal.ai/errors/insufficient-scope",
  "title": "Insufficient scope",
  "status": 403,
  "detail": "..."
}

`type` is stable and safe to branch on in code. `detail` is specific to your request and is the field to read for the particulars; its wording may change.