Skip to main content
Profiles let you store multiple configurations and quickly switch between them. Each profile saves an access token, instance, workspace, and branch — so you can target different environments without re-authenticating.

​
Profile Wizard

The profile wizard provides a step-by-step, interactive setup using an access token instead of browser-based login. This is useful for CI/CD environments, self-hosted instances, or when you prefer token-based auth.
1

Enter your access token

You’ll be prompted to enter your Xano access token (input is hidden for security).You can generate an access token from your Xano account settings under API Access.
2

Select your instance

The CLI fetches all instances associated with your account. Choose the one you want to work with.
? Select an instance:
❯ My Production Instance (us-east-1)
  My Staging Instance (eu-west-1)
3

Name your profile

Give this profile a name. This lets you maintain multiple profiles for different environments.
? Profile name: (default)
4

Select a workspace

Choose a workspace from your instance, or skip to configure later.
? Select a workspace:
❯ My App Backend
  Marketing Site API
  (skip)
5

Select a branch

If you selected a workspace, you’ll be asked to choose a branch. Skip to use the live branch.
? Select a branch:
❯ v1 (live)
  v2-development
  (skip)
The profile is saved and set as your default. You can create additional profiles to quickly switch between workspaces, branches, or instances.

​
Wizard for Other Environments

For self-hosted or beta environments, pass the -o flag: You can also pre-set the profile name:

​
List Profiles

Add -d for full details including origin URLs, workspace IDs, and masked tokens:

​
Create a Profile Manually

For scripting or CI/CD, create a profile directly without the interactive wizard:
FlagDescription
-tAccess token (required)
-iInstance origin URL (required)
-aAccount origin URL (for self-hosted)
-wWorkspace ID
-bBranch label
-k, --insecureSkip TLS certificate verification (for self-signed certs)
--defaultSet as the default profile

​
Edit a Profile

Update any field on an existing profile: To clear a field, use the corresponding --remove-* flag: You can also enable or disable insecure mode (self-signed certificate support) on an existing profile: When a profile has insecure mode enabled, all commands using that profile automatically skip TLS certificate verification.

​
Get Default Profile

Print the name of the current default profile:

​
Switch Default Profile

​
Verify Profile

Check that your profile is configured correctly: This calls the Xano API and returns a summary of your current setup — CLI version, account details, instance, workspace, and branch. Use -o json for the full JSON response.
Output the access token for the default profile (useful for piping to other commands):
Output the workspace ID for the default profile:

​
Change Workspace Interactively

Switch the workspace on a profile by selecting from a list of available workspaces: To target a specific profile:

​
Delete a Profile

Add -f to skip the confirmation prompt.

​
Using a Profile for a Single Command

Override the default profile for any command with -p: You can also set the XANO_PROFILE environment variable: