Error codes
auth.scope.insufficient
Variant of `auth.forbidden_scope` returned by the API's scope check.
auth.scope.insufficient is returned at HTTP 403.
When this fires
Returned when an authenticated principal hits an endpoint whose required scopes are not a subset of the credential's granted scopes.
What to do
Same remediation as auth.forbidden_scope. Both codes describe the same underlying condition — handle them identically in your SDK exception handler.
See also
- SDK reference — the Python and TypeScript SDKs raise typed exceptions for codes in this namespace.
- Error code index — every code the runtime can return.