Sign Out of All Sessions (Global Logout)
DELETE/api/auth/token
Signs the authenticated user out of every browser and device — across every subdomain and every pod.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
What it does:
- Increments the user's central
auth_versioncounter by 1 - Deletes every Session-type Personal Access Token for the user (Sanctum bearer sessions)
- Invalidates the caller's own cookie session (if cookie-authenticated)
- Busts the per-user auth_version cache so the next request reads the new value immediately
What survives:
- Personal Access Tokens (PAT type) — long-lived API credentials. Revoke individually from Settings → Developer → Personal Access Tokens.
- Integration tokens (3PL / channel connections). Revoke individually from Connected Apps.
How other devices are kicked: every request authenticated by a Session token (or cookie session) carries a stamped auth_v. The EnforceAuthVersion middleware compares it to the current auth_version on the user row; if the stamp is stale, the request is rejected with 401 / ERR_AUTH_REVOKED and the cookie session is invalidated. This works across all pods because users.auth_version lives in the central DB.
Authentication: Requires Bearer token (Session type) or active cookie session.
Note: Not available when CACHE_STORE is 'array' — the auth_version cache bust would be a no-op across processes.
Request
Responses
- 200
- 401
- 403
- 429
- 501
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.
Not Implemented