aac sso logout
Delete the cached AAC session for a tenant.
Removes ~/.aac/credentials/{tenant}.session. Sessions are self-contained short-lived tokens with no server-side revocation surface in V4 — logout is a local-cache operation by design. The api_key credential file is untouched.
Synopsis
aac sso logout
[-h]
[--profile PROFILE]
[--admin-url ADMIN_URL]
[--data-plane-url DATA_PLANE_URL]
[--output {json,table}]
[--tenant-id TENANT_ID]
Arguments
| Argument | Type | Required | Default | Description |
|---|---|---|---|---|
-h, --help |
flag | no | — | show this help message and exit |
--profile |
value | no | — | Profile to run under (selection: --profile > AAC_PROFILE > reserved baseline main). aac profile list shows what exists. |
--admin-url |
value | no | — | Admin-surface base URL (overrides profile). |
--data-plane-url |
value | no | — | Data-plane-surface base URL (overrides profile). |
--output |
json | table |
no | json |
Output mode: json (the default) or table. |
--tenant-id |
value | no | — | Tenant whose session to remove (default: profile/env tenant). |
Output
--output json (the default) prints one JSON document to standard output; --output table prints a readable table instead. Progress notes and diagnostics go to standard error, so the JSON stays parseable.
Exit codes
| Code | Meaning |
|---|---|
0 |
Success. |
1 |
The control plane or the identity provider rejected the request. |
2 |
Usage error: an invalid flag, value or flag combination. |
3 |
A local configuration or state problem: profile, credential file, cached session or agent. |
4 |
Transport failure: an endpoint could not be reached. |
Related commands
aac ssoaac sso register-idp— Register a tenant↔IdP connection.aac sso generate-idp-recovery-key— Generate offline tenant IdP recovery-key artifacts.aac sso enroll-idp-recovery-key— Enroll a tenant's IdP recovery public verifier.aac sso list-idp-recovery-keys— List IdP recovery-key lifecycle metadata.aac sso rotate-idp-recovery-key— Replace the ACTIVE IdP recovery public verifier.aac sso revoke-idp-recovery-key— Terminally revoke the ACTIVE IdP recovery key.aac sso request-idp-repair— Sign and submit one exact IdP connection repair request.aac sso approve-idp-repair— AAC Ops approves one exact tenant-signed IdP repair.aac sso list-idp— List safe tenant IdP connection handles without authentication.aac sso replace-idp— Replace one tenant IdP connection from a complete file.aac sso whoami— Show cached session identity/expiry and the profile's saved AAC-assigned domain.aac sso login— Sign in via your tenant's IdP; caches an AAC session.