Manage CLI profiles
Work with multiple Vantage environments and identities from the CLI.
Profiles let you keep separate endpoint and authentication contexts for different Vantage environments, such as production, staging, or a private deployment.
Inspect the profile commands
If this is your first time using profiles, start with:
uvx v8x profile --help
uvx v8x profile create --help
The core workflow is:
uvx v8x profile listto inspect existing profilesuvx v8x profile create <name> --activateto add a new profile and make it currentuvx v8x profile use <name>to switch to an existing profileuvx v8x whoami --jsonto confirm the active identity and target environment
List profiles
uvx v8x profile list
This shows the profiles configured on your machine and indicates which one is active.
Success looks like this: you can see the available profile names and identify the active one before making changes.
Create a profile
Create and activate a new profile:
uvx v8x profile create staging --activate
This creates a new named profile and makes it the default target for subsequent commands.
Key options:
--activateto switch immediately after creation- environment-specific endpoint options when you are targeting a private deployment
Success looks like this: the new profile appears in uvx v8x profile list, and the active profile changes to the one you just created.
Switch profiles
Switch to an existing profile:
uvx v8x profile use staging
This changes the active profile without recreating it.
Success looks like this: later commands run against the selected profile, and uvx v8x whoami reflects that environment.
Confirm the active identity
Inspect the current identity and active profile:
uvx v8x whoami --json
This confirms which user and environment the CLI is currently using.
Success looks like this: the output includes the expected profile, identity, and token status for the environment you intended to target.