Skip to content

unauthenticated ​

The request carried no credential this surface accepts.

StatusTitletype
401Unauthenticatedhttps://substrat.net/errors/unauthenticated

What it means ​

The surface could not tell who is calling. There was no session cookie and no bearer token, or the one sent was expired, revoked, or minted for another audience. It is about identity only. Whether a known caller may do something is permission_denied.

When it is returned ​

  • A route behind sign-in was reached with no session and no bearer token.
  • A bearer token failed verification: expired, signed by an issuer the surface does not trust, or minted for another audience.
  • The control plane's /api was reached without the staff session it expected; detail names what was wrong with it.

What it carries ​

  • Nothing beyond the members every problem carries.

Relayed from a scope store, it may also carry storeCode and storeBody. See the body for the members any problem may carry.

What to do ​

Sign in again or refresh the token, then retry once. The same credential gets the same answer. A browser app treats this as the cue to show sign-in, not as an error to display.

In /openapi.json ​

Documented on every operation's failure responses.

Every error code