Skip to content
ShiftGraph

HTTP 403, authentication and identity

AUTH-017

This token lacks the required scope.

What it means

The token is valid but was not granted the scope this endpoint needs.

What to do

Issue a token with the scope named in the endpoint's documentation. Scopes are chosen explicitly at creation; none is preselected.

The response

Every failure arrives in this shape. The trace_id is worth keeping: it identifies the request in our logs and carries nothing about your data.

{
  "type": "https://shiftgraph.dev/errors/AUTH-017",
  "title": "This token lacks the required scope.",
  "status": 403,
  "code": "AUTH-017",
  "trace_id": "01J8Z…"
}

Related codes

Sessions, second factors, sign-in methods, and the credentials that reach the API. A second factor is required of every account, so several of these have no bypass by design.

The full error reference, or write to support@shiftgraph.dev with the trace id.