Skip to main content

scout context

Manage authentication contexts when working with multiple Scout organizations. Each context stores an account name, authentication endpoint, and Scout API URL.

scout context demo

Usage

scout context <SUBCOMMAND>

Subcommands

SubcommandDescription
listList all configured contexts
set <NAME>Set the active context
showDisplay details of the current context
delete <NAME>Delete a context and its credentials
set-api-url <URL>Set the Scout API URL for a context

scout context list

List all configured contexts. The active context is marked with *.

scout context list

scout context set

Switch to a different account context.

scout context set <NAME>

Arguments:

ArgumentTypeDescription
NAMEstringContext name to activate

Example:

scout context set staging-org

scout context show

Display details of the current active context, including name, endpoint, account slug, and API URL.

scout context show

scout context delete

Delete a context and remove its stored credentials.

scout context delete <NAME>

Arguments:

ArgumentTypeDescription
NAMEstringContext name to delete

Example:

scout context delete old-org

scout context set-api-url

Override the Scout API URL for a context. Useful when connecting to a self-hosted Scout instance.

scout context set-api-url <URL>

Arguments:

ArgumentTypeDescription
URLstringScout API endpoint URL

Flags:

FlagTypeDefaultDescription
-a, --accountstringactive contextTarget a specific context instead of the active one

Example:

scout context set-api-url https://scout-api.internal.example.com

Example Workflow

Set up multiple organizations and switch between them:

# Authenticate with two organizations
scout login --account prod-org
scout login --account staging-org

# List contexts
scout context list

# Switch to staging
scout context set staging-org

# Verify
scout context show

See Also

  • login — authenticate with Scout
  • status — check authentication status
  • Global Flags — use -a to override context per-command
Was this page helpful?