> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atollhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Common issues

> Fix common Atoll setup, CLI, API, permission, webhook, and documentation 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:

```bash theme={null}
: "${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:

```bash theme={null}
atoll issue archive ATOLL-42
```

## Status update fails

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

```http theme={null}
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.