Skip to main content

verdictan configure

Use verdictan configure to save a region for a terminal profile and list local profile names. These commands work locally. They do not require an API connection or sign-in.

The CLI connection file is separate from the gateway's policy-config.yaml. For the resolved region and its source, use verdictan regions current.

Usage​

verdictan configure set region <region> [--profile <name>] [--config <path>]
verdictan configure get region [--profile <name>] [--config <path>]
verdictan configure list-profiles [--config <path>]

Options​

OptionApplies toEffect
<region>set regionRequired. Accepts global or two lowercase words separated by a hyphen, such as eu-west.
--profile <name>set region, get regionSelect the profile. The default is default. An empty name is invalid.
--config <path>AllSelect the CLI connection file. Otherwise, use VERDICTAN_CONFIG, then ~/.verdictan/config.yaml.

--config can also appear before the subcommand, such as verdictan configure --config ./cli.yaml list-profiles. These commands print text. They do not accept --json, --api-url, or a credential flag. list-profiles does not accept --profile because it lists all local profile names.

Save and read a region​

  1. Save a region for a named profile:

    verdictan configure set region eu-west --profile work
  2. Read that profile's saved region:

    verdictan configure get region --profile work

set region creates the parent directory and file when necessary. It writes profiles.<name>.default_region and retains other configuration entries. The command rewrites YAML, so existing comments and formatting can change. It prints the selected region, profile, and destination path.

The configuration includes this entry:

~/.verdictan/config.yaml
profiles:
  work:
    default_region: eu-west

get region prints only the saved region and a newline. It first reads the profile's default_region, then the root-level default_region if the profile has none. It does not read VERDICTAN_REGION or query the API catalog. If neither saved value exists, it stops with no region configured for profile '<name>'.

To keep connection settings in a project file:

verdictan configure set region eu-west --profile work --config ./cli.yaml
verdictan configure get region --profile work --config ./cli.yaml

The command checks the region's format. It does not confirm that the region exists in the API catalog. A saved region does not change the API URL or the provider locality in a gateway configuration.

List profiles and sign in​

verdictan configure list-profiles

The command prints one name per line in byte-sorted order, without duplicates. The list always includes default. It also includes names from the config file's profiles map, its root profile value, and stored terminal credentials. An alternate --config changes the configuration source, not the credential store.

A listed profile does not establish that its credential exists or remains valid. Use the same name when you sign in and examine identity:

verdictan auth login --profile work
verdictan auth whoami --profile work

The environment variable VERDICTAN_API_TOKEN takes priority over the selected terminal session. For all credential sources, see Authentication.

ACP uses kalkidan as its default profile. Most terminal commands use default. Desktop authorization stores credentials in the system keyring. configure list-profiles lists terminal configuration and credential names, not ACP agent definitions or all desktop accounts. See verdictan acp for coding-agent profiles.

Limits and failure behavior​

ConditionResult and action
Region has an invalid formatThe write stops. Use a key such as eu-west, us-east, or global.
Configured region is absent from the catalogThe write succeeds. Query verdictan regions list before using that region.
Selected file does not existset region creates it. get region and list-profiles stop if an explicit path cannot be read.
YAML is invalid or the root is not a mappingCorrect the file before writing a setting.
profiles or a profile entry is not a mappingThe write stops without replacing that entry. Correct its structure.
No saved region existsget region stops with an error. Set the region for that profile.
Directory or file cannot be writtenCorrect the destination path or its access permissions.

There are no configure commands to delete a profile, change its API URL, or store a token. Use the connection flags supported by each command and the authentication workflow for credentials.

Complete command reference​

Select a command for its complete input table. Default input means the value used when that option is omitted. A value marked Not set can still come from configuration or the environment, as described above. Set uppercase variables in example templates to your own resource IDs and paths before use. See CLI scripting for quoting, output streams, confirmation, and exit codes.

Next steps​