Revoke a `vr_session_*` token

Alpha

POSThttps://api.voxrouter.ai/v1/auth/logout

Revoke the bearer CLI session token. Used by `voxrouter logout`. Idempotent: returns `{ revoked: false }` (200) when the token is already revoked, expired, or wasn't a CLI session in the first place. `pk_*` keys are silently ignored (return revoked=false) because pk_* lifecycle belongs to /v1/keys.

bash

curl -X POST https://api.voxrouter.ai/v1/auth/logout \
  -H "Authorization: Bearer $VOXROUTER_API_KEY"

Headers

AuthorizationstringRequired

Bearer token. Send as Authorization: Bearer pk_....

Response

Logout completed (or was a no-op).

json

{
  "revoked": false
}

revokedbooleanRequired

`true` if a CLI session row was deleted; `false` when the token wasn't a known CLI session (already revoked, expired, or not a `vr_session_*` token in the first place). Idempotent — second call with the same token returns `false`.

Errors

Non-2xx responses return a JSON body with a machine-readable error code and an optional details string.

Status	Meaning
401	Missing or invalid API key.