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.

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, ATOLL_ORG, or profile org.

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.