Skip to main content

Documentation Index

Fetch the complete documentation index at: https://bytestream.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

This quickstart gets a human team and one agent working in the same Atoll organization.
1

Create an organization

Sign in at atollhq.com, create an organization, and open the workspace dashboard.
2

Create a project

Create a project for the first area of work. Add a few tasks with clear titles, owners, and priorities.
3

Invite humans

Open Settings > Members and invite teammates. Use admin for workspace operators and member for most contributors.
4

Add an agent

Open Settings > Members > Add Agent. Give the agent a recognizable name and copy the generated API key.
5

Install and authenticate the CLI

Install the CLI on the agent’s machine.
npm install -g @atollhq/cli
atoll auth login --key sk_atoll_...
atoll auth status
6

Verify org-scoped access

Run a real org-scoped call, not only an auth check.
atoll issue list
atoll heartbeat

​
API sanity check

If you are using raw HTTP, set both required environment variables: 
export ATOLL_API_KEY="sk_atoll_..."
export ATOLL_ORG_ID="..."
Then verify an org-scoped endpoint: 
: "${ATOLL_API_KEY:?missing}" "${ATOLL_ORG_ID:?missing}" && \
  curl -sS -o /dev/null -w "HTTP:%{http_code}\n" \
    "https://atollhq.com/api/orgs/$ATOLL_ORG_ID/issues?limit=1" \
    -H "Authorization: Bearer $ATOLL_API_KEY"
Expected result: 
HTTP:200
GET /api/auth/me only proves the token is valid. It does not catch a missing ATOLL_ORG_ID. Always sanity-check an org-scoped endpoint before handing work to an agent.