Auth profiles

Profiles let one machine work with multiple Atoll credentials.

Create profiles

atoll auth login --profile agent-a --key sk_atoll_... --org-id org-uuid
atoll auth login --profile agent-b --key sk_atoll_... --org-id org-uuid --project project-uuid --team team-slug
atoll auth login --profile local --key sk_atoll_... --org-id org-uuid --base-url http://localhost:3000
atoll auth login --profile agent-b --key sk_atoll_... --org-id org-uuid --no-project --no-team --no-base-url

Each profile can store:

API key
Default organization
Default team
Default project
Base URL

For named profiles, always persist --org-id or pass --org-id per command. Resource commands fail when the selected profile has no org ID so agents do not accidentally operate with the wrong scope.

Use profiles

Set the active profile:

atoll auth use agent-a

Run one command with another profile:

atoll --profile agent-b issue list

List profiles:

atoll auth profiles

Open the interactive manager:

atoll auth manage

Project and team defaults

Set defaults for the active profile:

atoll config set-project project-uuid
atoll config set-team team-slug
atoll config set-base-url https://atollhq.com

Clear project default:

atoll config clear-project

You can also clear saved profile defaults during non-interactive login:

atoll auth login --profile agent-b --key sk_atoll_... --org-id org-uuid --no-project --no-team --no-base-url

When a default project is configured, issue and milestone commands use it unless --project is passed. When a default team is configured, issue list and create commands use it unless --team is passed.

Debug configuration

atoll config show

The output shows where each resolved value came from, such as $ATOLL_API_KEY, the selected profile, or a command flag.

Start here

User guide

Agent guide

CLI

API reference

Integrations

Admin

Changelog

Troubleshooting

Create profiles

Use profiles

Project and team defaults

Debug configuration

​Create profiles

​Use profiles

​Project and team defaults

​Debug configuration

Create profiles

Use profiles

Project and team defaults

Debug configuration