credentials
List and revoke the CLI logins on your user
Each solwyn login creates one CLI login on your user, named by its --label (the short hostname by default). Logins minted with solwyn login --no-store for SOLWYN_TOKEN appear too, under their label. credentials lists them and revokes them. Tokens are never shown. Revocation is immediate: the next request with that login fails.
solwyn credentials list
solwyn credentials revoke 91be7d03
solwyn credentials revoke --currentBoth subcommands need a Solwyn login; an API key cannot list or revoke logins. Revoking only removes access, so any of your logins may revoke any other, itself included, without a browser approval. The dashboard shows the same list under Settings, CLI logins. See Scoped login for what a login can do and how long it lasts.
credentials list
List your active CLI logins: each login's ID, label, scopes, creation, last use and expiry. The login this CLI is using is marked current. Only active logins are listed.
$ solwyn credentials list
ID Label Scope Created Last used Expires
6c1f2a90 dev-laptop read,contain 2026-10-30 2026-10-30 2026-11-29 current
91be7d03 ci-runner read 2026-10-30 never 2026-11-29The table shows the first 8 characters of each ID. --json returns the full IDs and each login's client, version and token prefix under credentials.
| Contract | |
|---|---|
| Auth | login |
| Exit codes | 0 success · 1 generic/API · 2 usage · 3 auth |
| JSON schema | solwyn.credentials.list.v1 |
credentials revoke
Revoke one of your CLI logins.
solwyn credentials revoke [<credential_id>] [--current]| Option | Type | Default | Purpose |
|---|---|---|---|
CREDENTIAL_ID | argument | none | A login ID, or a unique prefix of 8 or more characters. |
--current | boolean | false | Revoke the login in use. When it is the stored login, also clear it from the credential store. |
Give an ID or --current, not both. A prefix shorter than 8 characters, or one that matches several logins, exits 2. A prefix that matches no active login exits 5 with cli_credential_not_found. Revoking the stored login also clears it from the credential store. Revoking a SOLWYN_TOKEN login leaves any stored login alone; remove the token from wherever you set it.
{"schema":"solwyn.credentials.revoke.v1","id":"91be7d03-0000-4000-8000-000000000002","label":"ci-runner","revoked":true,"current":false,"cleared_local_login":false}| Contract | |
|---|---|
| Auth | login |
| Exit codes | 0 success · 1 generic/API · 2 usage · 3 auth · 5 not found |
| JSON schema | solwyn.credentials.revoke.v1 |
Related
- Scoped login: what a CLI login can do, approvals, expiry and
SOLWYN_AUTH login/logout: create a login, or revoke this machine's login and clear its stored credentialsapprovals: approve changes a login can't make on its own