Skip to main content
cops auth use sets the named profile as the current active profile. The change is persisted to config.json immediately and applies to all subsequent cops commands in any terminal session.

​
Usage

cops auth use <profile>

​
Arguments

​
profile
string
required
The name of the profile to activate. Must match a profile that already exists. Run cops auth profiles to see available profile names.

​
Examples

cops auth use dc-prod

​
What “active” means

The active profile is the default source of credentials for all cops commands that authenticate against an Atlassian product. Any command that supports the --profile flag can override this on a per-invocation basis without changing the active profile. The active profile name is stored in config.json under the currentProfile key: 
{
  "currentProfile": "dc-prod",
  "profiles": [
    { "name": "dc-prod", "jira": { ... } },
    { "name": "dc-staging", "jira": { ... } }
  ]
}

​
Notes

If the named profile does not exist, the command exits with an error. Check available profiles first with cops auth profiles.

cops auth profiles

List all configured profiles.

cops auth login

Create a new profile.

cops auth logout

Unset the active profile.

Build docs developers (and LLMs) love

Get started for freeTalk to us