Docs
CLI

silos auth & silos config

Log in, manage API keys, and configure CLI defaults like the API endpoint and output format.

The silos auth group handles authentication and API keys; silos config manages local CLI defaults.

silos auth

Terminal
silos auth <subcommand>

auth login

Log in to Silos. The CLI stores your credentials locally so subsequent commands are authenticated.

Terminal
silos auth login

auth logout

Log out and clear stored credentials.

Terminal
silos auth logout

auth whoami

Show the currently authenticated user.

Terminal
silos auth whoami

Managing API keys

API keys authenticate programmatic access — CI pipelines, scripts, and the REST API. Manage them with silos auth keys.

auth keys list

List your API keys.

Terminal
silos auth keys list

auth keys create

Create a new API key with a descriptive name. The key value is shown once on creation — store it somewhere safe.

Terminal
silos auth keys create "ci-pipeline"
ArgumentDescription
<name>A descriptive name for the key.

The full key is only displayed at creation time. If you lose it, revoke the key and create a new one rather than trying to recover it.

auth keys revoke

Revoke an API key by its ID. Any client using it stops working immediately.

Terminal
silos auth keys revoke key_abc123
ArgumentDescription
<key_id>The ID of the key to revoke.

silos config

silos config manages local CLI configuration — defaults the CLI remembers between runs.

Terminal
silos config <subcommand>

config show

Show the current configuration.

Terminal
silos config show

config set

Set a configuration value.

Terminal
silos config set default_region dal
ArgumentDescription
<key>Configuration key.
<value>Value to set.

config get

Read a single configuration value.

Terminal
silos config get default_region
ArgumentDescription
<key>Configuration key to read.

The global --api-url / SILOS_API_URL and --api-key / SILOS_API_KEY flags override stored configuration for a single command, which is the cleanest way to use a scoped key in CI. See CLI overview.

On this page