unauthenticated
The request carried no credential this surface accepts.
| Status | Title | type |
|---|---|---|
401 | Unauthenticated | https://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
/apiwas reached without the staff session it expected;detailnames 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.