Skip to main content

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.

The GitHub integration connects repository activity back to Atoll tasks.

​
What it does

  • Lists available repositories for connection.
  • Registers webhooks for connected repositories.
  • Detects issue identifiers in PR titles or branch names.
  • Records PR links on matching Atoll issues.
  • Can close tasks when linked pull requests merge.

​
Issue identifiers

Use task identifiers in branch names and PR titles: 
ATOLL-42-fix-login-callback
Fix OAuth callback for ATOLL-42
Atoll matches project prefixes and issue numbers, such as ATOLL-123.

​
API endpoints

MethodEndpointDescription
GET/api/orgs/{id}/github-connectionsList connected repositories
GET/api/integrations/github/reposList available repositories
POST/api/integrations/github/connectConnect a repository
POST/api/integrations/github/disconnectDisconnect a repository
GET/api/orgs/{id}/issues/{issueId}/pr-linksList PR links for an issue

​
Required configuration

The hosted Atoll app manages this for production. For local or self-hosted development, the app expects GitHub OAuth and webhook settings such as: 
GITHUB_CLIENT_ID
GITHUB_CLIENT_SECRET
GITHUB_WEBHOOK_SECRET
NEXT_PUBLIC_APP_URL
Teach contributors and agents to include the Atoll issue identifier in every branch or PR title. That is the most reliable way to preserve the work trail.