logout

Logs you out of a profile: by default it revokes the session token on the server, then clears the token and all session metadata (refresh token, session id, DPoP keys, expiry) from your local config.json. It targets the active profile unless you pass --profile <name>. If the profile already has no token, it reports already_logged_out and does nothing.

Use it to end a session or before switching accounts. Pass --no-revoke to clear the token only locally without contacting the server — handy when you're offline or the token is already expired. Even when server revocation is requested, the local token is cleared regardless of the server's response, so logout always leaves the profile credential-free; a network failure or a 401 from the server is logged but not treated as a hard error. To sign back in, run simetrik login.

See also: login, config show, config use-profile. Requires CLI access to the workspace. See permissions.

Flags

• -p, --profile <name> — Profile to log out (default: active)
• --revoke — Also revoke the token on the server (default)
• --no-revoke — Skip server-side token revocation

Examples

simetrik logout
simetrik logout --profile staging
simetrik logout --no-revoke

Exit codes