Loading the search index…

Status 403

Scope is missing

insufficient_scope

When it happens

The app lacks the scope the endpoint needs; required_scope names it, as does the WWW-Authenticate header. An endpoint that accepts any of several scopes lists them in accepted_scopes — any one is enough.

What to do

Ask the store to grant the scope to the app. The token stays the same: scopes belong to the app.

Can’t find the answer, or the error keeps coming back? Write to us and quote the X-Request-Id from the response so we can find the request. Contact us

Endpoints that return it

A common error: it is not tied to particular endpoints, and almost any call can return it.

Response body

application/problem+json · ForbiddenProblem

  • typestringrequired

    Machine type of the problem: a stable code to branch on, such as insufficient_scope. Every type has a page in the error catalog.

  • titlestringrequired

    Short summary of the problem in the language of the request.

  • statusintegerrequired

    HTTP status of the response.

  • detailstring

    Explanation of this occurrence in the language of the request.

  • required_scopestring

    For insufficient_scope — the scope the endpoint needs.

  • accepted_scopesarray of string

    For insufficient_scope — the scopes the endpoint accepts: any one is enough. For an endpoint with one scope — that scope alone.

← Errors