SOLWYN
Commands

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.

Terminal
solwyn credentials list
solwyn credentials revoke 91be7d03
solwyn credentials revoke --current

Both 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.

Terminal
$ 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-29

The 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
Authlogin
Exit codes0 success · 1 generic/API · 2 usage · 3 auth
JSON schemasolwyn.credentials.list.v1

credentials revoke

Revoke one of your CLI logins.

Terminal
solwyn credentials revoke [<credential_id>] [--current]
OptionTypeDefaultPurpose
CREDENTIAL_IDargumentnoneA login ID, or a unique prefix of 8 or more characters.
--currentbooleanfalseRevoke 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
Authlogin
Exit codes0 success · 1 generic/API · 2 usage · 3 auth · 5 not found
JSON schemasolwyn.credentials.revoke.v1
  • 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 credentials
  • approvals: approve changes a login can't make on its own

On this page