authentication

Logout user. Tokens are stateless and don't need revocation.

Invariant: the only backend effect of this endpoint is to clear the refresh cookie, idempotently. It never mutates a user, a session record, a token store, or anything else, and behaves identically on the first call and the tenth. Authentication is used only to decide whether the action can be attributed in the audit log — it is deliberately callable with an expired, missing, or absent access token, which is exactly the situation after an offline logout retry or any 15-minute access-token expiry. If a future change gives this endpoint any other effect, it must stop being callable unauthenticated.

Client should discard both access and refresh tokens after logout.

post/api/v1/auth/logout

Request

  • The document declares no server URL.
  • Auth: none declared

Response

Successful Response

unknown required

Changes

    • warning

      deleted the cookie request parameter access_token

    • info

      removed the non-success response with the status

    • info

      the endpoint scheme security OAuth2PasswordBearer was removed from the API

    • info

      removed the non-success response with the status