GitHub

Access repositories, issues, pull requests, actions, deployments, growth insights and traffic analytics.

Install

amodal connect github

Authentication

Bearer token authentication.

• GITHUB_TOKEN — Personal access token (classic) or fine-grained token

Token scopes determine access: repo for private repos, public_repo for public only. Fine-grained tokens can be scoped to specific repositories.

Endpoints

Repositories

• GET /repos/:owner/:repo — Get repository details
• GET /repos/:owner/:repo/commits — List commits
• DELETE /repos/:owner/:repo — Delete a repository (disabled)

Issues

• GET /repos/:owner/:repo/issues — List issues
• POST /repos/:owner/:repo/issues — Create an issue (confirmation)
• PATCH /repos/:owner/:repo/issues/:issue_number — Update an issue (confirmation)
• POST /repos/:owner/:repo/issues/:issue_number/comments — Add comment (confirmation)

Pull Requests

• GET /repos/:owner/:repo/pulls — List pull requests
• POST /repos/:owner/:repo/pulls — Create a pull request (confirmation)
• GET /repos/:owner/:repo/pulls/:pull_number — Get PR details
• PUT /repos/:owner/:repo/pulls/:pull_number/merge — Merge a PR (confirmation)

Actions

• GET /repos/:owner/:repo/actions/runs — List workflow runs
• GET /repos/:owner/:repo/actions/runs/:run_id — Get workflow run details
• POST /repos/:owner/:repo/actions/runs/:run_id/rerun — Re-run a workflow (confirmation)

Deployments

• GET /repos/:owner/:repo/deployments — List deployments

Growth & Insights

• GET /repos/:owner/:repo/stargazers — List stargazers (timestamps via Accept header)
• GET /repos/:owner/:repo/forks — List forks
• GET /repos/:owner/:repo/traffic/views — Get page views (14-day window)
• GET /repos/:owner/:repo/traffic/clones — Get clones (14-day window)
• GET /repos/:owner/:repo/traffic/popular/referrers — Get top referral sources
• GET /repos/:owner/:repo/traffic/popular/paths — Get popular content paths
• GET /repos/:owner/:repo/releases — List releases
• GET /repos/:owner/:repo/releases/latest — Get latest release
• GET /repos/:owner/:repo/contributors — List contributors

Search

• GET /search/issues — Search issues and PRs
• GET /search/code — Search code

Entities

• repo, issue, pull, merge, stargazer, fork, traffic, release, contributor

Rules

• Authenticated rate limit: 5,000 requests/hour; Search API: 30 requests/minute
• Issues and PRs share the same number namespace — the issues endpoint returns both (filter by pull_request field presence)
• Draft PRs cannot be merged — must be marked as ready first
• mergeable field may be null while GitHub computes mergeability — poll until non-null
• Traffic endpoints require push access; data available for the last 14 days only
• Stargazers timestamps require Accept: application/vnd.github.star+json header
• Contributors endpoint may be slow for large repos (GitHub returns 202 while computing)