insufficient_scope
The key authenticates correctly but does not carry the scope this operation requires. Scopes are granted when the key is issued and are not widened at call time.
| Code | Type | HTTP | Category |
|---|---|---|---|
insufficient_scope | authorization_error | 403 | Authorization |
Cause
The key authenticates correctly but does not carry the scope this operation requires. Scopes are granted when the key is issued and are not widened at call time.
What to do
Issue a key including the scope named in error.message — read scopes for queries, write scopes for changes — and use it for this call.
Related
All Authorization error codes
Causes and actions for errors in this category.
Error codes by category
Find an error by the category that emits it.
Full reference table
All codes, HTTP statuses, types and descriptions in one reference.
Error model
Interpret the error envelope and handle errors by code.