auth_scope_insufficient

What happened

Your key is valid, but it is not allowed to read this endpoint.

Why it usually happens

The endpoint declares one or more scopes, and your key does not carry all of them. A report often spans several scopes at once.

How to fix

• Look up what the endpoint needs in the scope table. A report is served only when your key carries every scope it declares.
• Read message on the error — it names the first scope your key is missing.
• Mint a new key with that scope, or with read:* if the key is for a dashboard or an AI agent that will read broadly.
• Do not reuse a read-only key for write endpoints, or an events:write key for reads — they are separate scopes.

Envelope

{
  "error": {
    "code": "auth_scope_insufficient",
    "message": "This API key is not allowed to access write endpoints.",
    "param": null,
    "doc_url": "https://docs.fullvision.io/errors/auth_scope_insufficient",
    "trace_id": "tr_01HXYZ..."
  }
}