doctl auth switch
Generated on 23 Jun 2025
from doctl version
v1.131.0
Usage
doctl auth switch [flags]Description
This command allows you to switch between authentication contexts you’ve already created.
To see a list of available authentication contexts, call doctl auth list.
For details on creating an authentication context, see the help for doctl auth init.
Example
The following example switches to the context your-team:
doctl auth switch --context your-teamFlags
| Option | Description |
|---|---|
--help, -h |
Help for this command |
Related Commands
| Command | Description |
|---|---|
| doctl auth | Display commands for authenticating doctl with an account |
Global Flags
| Option | Description |
|---|---|
--access-token, -t |
API V2 access token |
--api-url, -u |
Override default API endpoint |
--config, -c |
Specify a custom config file Default: |
--context |
Specify a custom authentication context name |
--http-retry-max |
Set maximum number of retries for requests that fail with a 429 or 500-level error
Default: 5 |
--http-retry-wait-max |
Set the minimum number of seconds to wait before retrying a failed request
Default: 30 |
--http-retry-wait-min |
Set the maximum number of seconds to wait before retrying a failed request
Default: 1 |
--interactive |
Enable interactive behavior. Defaults to true if the terminal supports it (default false)
Default: false |
--output, -o |
Desired output format [text|json] Default: text |
--trace |
Show a log of network activity while performing a command Default: false |
--verbose, -v |
Enable verbose output Default: false |