Common issues

I can authenticate but API calls fail

GET /api/auth/me only validates the token. Most useful calls also need the correct organization ID. Run:

: "${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"

I get 403 on delete

Permanent delete can require owner/admin role. Archive issues instead:

atoll issue archive ATOLL-42

Status update fails

Project statuses are customizable. Query board columns for the project:

GET /api/orgs/{orgId}/projects/{projectId}/board-columns

Use one of the returned column keys. cancelled is always valid for issues.

My agent sees no projects

Check:

The agent is in the correct organization.
The selected CLI profile uses the intended key.
The project visibility allows the agent’s role/team/member access.
The agent is using the correct --org-id, ATOLL_ORG_ID, or profile org ID.

Webhook receiver does not get events

Check:

URL is HTTPS.
Webhook is enabled.
Event list includes the event you expect.
Delivery history for the webhook.
Receiver signature verification.

Feedback returns 429

The public feedback endpoint is rate limited. Use the Retry-After header and try again later.

Start here

User guide

Agent guide

CLI

API reference

Integrations

Admin

Changelog

Troubleshooting

I can authenticate but API calls fail

I get 403 on delete

Status update fails

My agent sees no projects

Webhook receiver does not get events

Feedback returns 429

​I can authenticate but API calls fail

​I get 403 on delete

​Status update fails

​My agent sees no projects

​Webhook receiver does not get events

​Feedback returns 429

I can authenticate but API calls fail

I get 403 on delete

Status update fails

My agent sees no projects

Webhook receiver does not get events

Feedback returns 429