Skip to content
ShiftGraph

HTTP 401, authentication and identity

AUTH-003

Second factor required.

What it means

The password was accepted but the session has not completed its second factor. Every ShiftGraph account carries one; there is no account type that skips it.

What to do

Complete the factor prompt. If the device is unavailable, a recovery code signs you in and burns itself.

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-003",
  "title": "Second factor required.",
  "status": 401,
  "code": "AUTH-003",
  "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.