Skip to content

HTTP 401, authentication and identity

AUTH-004

That code didn't match. Try again.

What it means

The one-time code or recovery code was wrong, or was already used.

What to do

Re-read the code from your authenticator. If the clock on that device has drifted, correct it, since codes are time-based.

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-004",
  "title": "That code didn't match. Try again.",
  "status": 401,
  "code": "AUTH-004",
  "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.