Skip to content

GitHub MCP Server — 259 tools

The GitHub DADL turns GitHub's API into an MCP server that Claude, GPT or any MCP-compatible agent can consume directly. One YAML file declares all 259 tools — repo, org, issue, pull, team, workflow, and more — and ToolMesh serves them at runtime. No Python boilerplate, no per-endpoint code, no separate MCP server process.

Below: the endpoint coverage matrix, a two-block ToolMesh setup, the full tool reference grouped by GitHub feature area, required credential scopes.

Source: GitHub REST API v3

Credits: Dunkel Cloud GmbHUpdated: 2026-04-02

Which GitHub endpoints are covered?

25% (259 of ~1000 endpoints)

Focus: repos (full CRUD + fork + collaborators + topics), orgs (members + teams), issues (full CRUD + comments + events + reactions + types), sub-issues (hierarchy + reprioritize), issue dependencies (blocked_by + blocking), PRs (full CRUD + merge + reviews + review comments + requested reviewers), commits, branches (+ protection), rulesets (repo + org full CRUD + branch rules + rule suites), custom properties (org schema + repo/org values), git refs + objects (blobs, trees, commits), file management, labels, milestones, search (code + issues + repos + users + commits), releases (full CRUD), actions (workflows + runs + jobs + logs + secrets + artifacts + dispatch + permissions + fork PR approval policy), users, tags, webhooks, deployments (+ statuses), environments, gists (full CRUD), notifications, check runs/suites, commit statuses, starring, watching, pages, traffic (views + clones + paths + referrers), statistics (contributors + commit activity + code frequency + participation + punch card), code scanning, dependabot, secret scanning, packages (org + user: list, get, delete, restore, versions)

Missing: projects v2, codespaces, copilot, security advisories, rate limit API, git LFS, autolinks

Last reviewed: 2026-08-05

How do you configure the GitHub DADL?

  1. Navigate to GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
  2. Click 'Generate new token (classic)'
  3. Select scopes: repo (full access), read:org (list organizations), admin:org (org rulesets, custom properties, issue types), workflow (actions), admin:repo_hook (webhooks), delete_repo (delete repos), gist, notifications, read:packages, write:packages, delete:packages
  4. Copy the token (starts with ghp_ or github_pat_)

Environment variable: CREDENTIAL_GITHUB_TOKEN

Authentication docs ↗

How do you install the GitHub MCP server with ToolMesh?

Add to your backends.yaml:

- name: github
  transport: rest
  dadl: github.dadl
  url: "https://api.github.com"

Set the credential:

CREDENTIAL_GITHUB_TOKEN=your-token-here

What 259 tools does the GitHub DADL expose?

POSTcreate_repoCreate a new repository for the authenticated user. Set private=true for a private repo. auto_init=true creates an initial commit with a README.
POSTcreate_org_repoCreate a new repository in an organization. Requires org admin or repo creation permissions.
POSTcreate_repo_from_templateCreate a new repository from a template. The template must have is_template=true.
GETlist_user_reposList repositories for the authenticated user. Use type to filter (owner, member, all).
GETlist_user_repos_by_usernameList public repositories for a specific user.
GETget_repoGet a single repository by owner and name.
PATCHupdate_repoUpdate repository settings. Only include fields you want to change. Use for description, homepage, visibility, merge settings, etc.
DELETEdelete_repoDelete a repository. Requires delete_repo scope. This action is irreversible.
PUTreplace_topicsReplace all repository topics. Provide the full list of desired topics.
GETlist_repo_languagesList languages for a repository. Returns a map of language name to bytes of code.
GETlist_repo_contributorsList contributors to a repository, sorted by number of commits.
GETget_readmeGet the README file for a repository. Content is base64 encoded.
GETlist_forksList forks of a repository.
POSTcreate_forkFork a repository. Optionally specify an organization to fork into. Forking is asynchronous — poll get_repo to check when complete.
GETlist_collaboratorsList collaborators for a repository. Affiliation: outside, direct, all.
GETcheck_collaboratorCheck if a user is a collaborator. Returns 204 if yes, 404 if no.
PUTadd_collaboratorAdd a collaborator to a repository. Permission: pull, triage, push, maintain, admin.
DELETEremove_collaboratorRemove a collaborator from a repository.
GETlist_orgsList organizations the authenticated user belongs to.
GETget_orgGet an organization by name, including member count, repo count, and billing info.
GETlist_org_reposList repositories for an organization. Use list_orgs first to find org names.
GETlist_org_membersList members of an organization. Filter by role: all, admin, member.
GETlist_org_teamsList teams in an organization.
GETget_teamGet a team by its slug (URL-friendly name).
POSTcreate_teamCreate a team in an organization. Privacy: secret (visible to org members) or closed (visible to org members, searchable).
PATCHupdate_teamUpdate a team. Only include fields you want to change.
DELETEdelete_teamDelete a team from an organization.
GETlist_team_membersList members of a team. Role filter: all, member, maintainer.
PUTadd_team_memberAdd or update a team member. Role: member or maintainer.
DELETEremove_team_memberRemove a member from a team.
GETlist_team_reposList repositories a team has access to.
PUTadd_team_repoAdd a repository to a team. Permission: pull, triage, push, maintain, admin.
DELETEremove_team_repoRemove a repository from a team.
GETlist_issuesList issues for a repository. Also returns PRs unless filtered. State: open, closed, all. Note: GitHub treats PRs as issues — check for pull_request field to distinguish.
GETget_issueGet a single issue by number, including body, labels, assignees, and milestone.
POSTcreate_issueCreate a new issue. Labels are an array of label name strings. type is the org issue-type name (string, e.g. 'Bug') — see list_issue_types.
PATCHupdate_issueUpdate an issue. Set state to 'closed' to close it. Only include fields you want to change. type sets the org issue-type by name (string), or null to clear it.
PUTlock_issueLock an issue. Lock reason: off-topic, too heated, resolved, spam.
DELETEunlock_issueUnlock an issue.
GETlist_issue_commentsList comments on an issue or pull request.
POSTcreate_issue_commentAdd a comment to an issue or pull request. Body supports GitHub-Flavored Markdown.
PATCHupdate_issue_commentUpdate an issue comment.
DELETEdelete_issue_commentDelete an issue comment.
GETlist_issue_eventsList events for an issue (labeled, assigned, closed, reopened, etc.).
GETlist_issue_assigneesList available assignees for issues in a repository (users with push access).
GETlist_issue_reactionsList reactions on an issue. Content: +1, -1, laugh, confused, heart, hooray, rocket, eyes.
POSTcreate_issue_reactionCreate a reaction on an issue. Content: +1, -1, laugh, confused, heart, hooray, rocket, eyes.
POSTcreate_issue_comment_reactionCreate a reaction on an issue comment.
GETlist_pullsList pull requests for a repository. State: open, closed, all.
GETget_pullGet a single pull request including diff stats, mergeable state, and review status.
GETlist_pull_filesList files changed in a pull request with patch diffs and stats.
GETlist_pull_reviewsList reviews on a pull request (approved, changes_requested, commented).
POSTcreate_pullCreate a new pull request. head is the branch with changes, base is the target branch (e.g. main). Set draft=true to create a draft PR.
PATCHupdate_pullUpdate a pull request. Set state to 'closed' to close it. Only include fields you want to change.
PUTmerge_pullMerge a pull request. merge_method: merge, squash, or rebase. Optionally provide sha to ensure merging the expected head commit.
GETlist_pull_commitsList commits on a pull request, ordered chronologically.
POSTcreate_pull_reviewCreate a review on a pull request. event: APPROVE, REQUEST_CHANGES, or COMMENT. Body is the review summary.
GETlist_pull_review_commentsList review comments on a pull request (inline code comments, not issue comments).
POSTcreate_pull_review_commentCreate an inline review comment on a pull request. Specify path and line (or start_line + line for multi-line). side: LEFT or RIGHT for diff side.
GETlist_requested_reviewersList users and teams requested to review a pull request.
POSTrequest_reviewersRequest review from users or teams on a pull request.
DELETEremove_requested_reviewersRemove requested reviewers from a pull request.
GETlist_commitsList commits on a repository. Filter by sha (branch), path, author, or date range.
GETget_commitGet a single commit by SHA or ref, including full diff stats and file changes.
GETcompare_commitsCompare two commits. basehead format: 'base...head' (e.g. 'main...feature-branch'). Returns diff stats, commits, and file changes.
GETlist_branchesList branches for a repository.
GETget_branchGet a single branch including its latest commit SHA and protection status.
GETget_branch_protectionGet branch protection rules for a branch.
PUTupdate_branch_protectionUpdate branch protection rules. Set required_status_checks, enforce_admins, required_pull_request_reviews, and restrictions.
DELETEdelete_branch_protectionDelete branch protection rules for a branch.
POSTcreate_refCreate a git reference (branch or tag). For branches use ref='refs/heads/branch-name'. sha is the commit to point to.
PATCHupdate_refUpdate a git reference to point to a new SHA. ref is without 'refs/' prefix (e.g. 'heads/main'). Set force=true to do a non-fast-forward update.
DELETEdelete_refDelete a git reference. For branches use ref='heads/branch-name' (without refs/ prefix). For tags use ref='tags/tag-name'.
GETget_treeGet a git tree by SHA. Set recursive=true to get the full tree (all nested directories). Returns tree entries with path, mode, type, sha.
POSTcreate_treeCreate a git tree. Each tree entry has path, mode (100644=file, 100755=executable, 040000=directory, 160000=submodule, 120000=symlink), type (blob/tree/commit), and sha or content.
POSTcreate_blobCreate a git blob. Content can be utf-8 or base64 encoded (set encoding accordingly).
POSTcreate_git_commitCreate a git commit object. tree is the SHA of the tree, parents is an array of parent commit SHAs. Use with create_tree and update_ref for programmatic commits.
POSTcreate_tag_objectCreate an annotated tag object. object is the SHA to tag. type is the object type (commit, tree, blob). Use create_ref to create the tag ref afterwards.
GETget_contentGet file or directory contents. Files are base64 encoded. Directories return a listing. Use ref for a specific branch/tag/SHA.
PUTcreate_or_update_fileCreate or update a file. Content must be base64 encoded. To update an existing file, provide the current blob sha (from get_content). Creates a commit.
DELETEdelete_fileDelete a file from the repository. Requires the current blob sha (from get_content). Creates a commit.
GETsearch_codeSearch for code across repositories. Query syntax: 'keyword repo:owner/repo language:go path:internal'. Results include file path, repo, and text matches.
GETsearch_issuesSearch issues and PRs across repositories. Query syntax: 'bug repo:owner/repo is:open label:bug'. Use is:pr or is:issue to filter.
GETsearch_reposSearch repositories. Query syntax: 'keyword language:go stars:>100 topic:cli'. Sort: stars, forks, help-wanted-issues, updated.
GETsearch_usersSearch users. Query syntax: 'username type:user location:germany language:go followers:>100'.
GETsearch_commitsSearch commits. Query syntax: 'fix repo:owner/repo author:username committer-date:>2026-01-01'. Sort: author-date, committer-date.
GETsearch_topicsSearch topics by name. Returns matching topic names with descriptions and related info.
GETlist_releasesList releases for a repository, newest first.
GETget_latest_releaseGet the latest published release (not draft/prerelease).
GETget_releaseGet a single release by its numeric ID.
GETget_release_by_tagGet a release by tag name (e.g. 'v1.0.0').
POSTcreate_releaseCreate a release. tag_name is required. If the tag does not exist, target_commitish (branch or SHA) is used to create it. Set draft=true for unpublished releases.
PATCHupdate_releaseUpdate a release. Only include fields you want to change.
DELETEdelete_releaseDelete a release. Does not delete the associated git tag.
GETlist_release_assetsList assets (attached files) for a release.
DELETEdelete_release_assetDelete a release asset.
GETlist_workflowsList all workflows in a repository. Returns workflow ID, name, path, and state.
GETget_workflowGet a specific workflow by ID or filename (e.g. 'ci.yml').
POSTdispatch_workflowTrigger a workflow_dispatch event. ref is the branch/tag to run on. inputs is a map of workflow input values.
GETlist_workflow_runsList workflow runs for a repository. Filter by branch, status (queued, in_progress, completed), or event (push, pull_request).
GETget_workflow_runGet a single workflow run including status, conclusion, and timing.
GETlist_workflow_run_jobsList jobs for a workflow run. Filter by latest attempt or all attempts.
GETget_jobGet a single workflow job by ID, including steps with status and timing.
GETget_job_logDownload the log output of a workflow job. Returns plain text with timestamps. The API responds with a 302 redirect to a temporary download URL which is followed automatically.
POSTcancel_workflow_runCancel a workflow run that is in progress or queued.
POSTrerun_workflowRe-run an entire workflow run. Only works for completed runs.
POSTrerun_failed_jobsRe-run only the failed jobs in a workflow run.
DELETEdelete_workflow_runDelete a workflow run. The run must be completed.
GETlist_workflow_run_artifactsList artifacts for a workflow run. Artifacts are files produced during a run (logs, binaries, test results).
GETlist_repo_secretsList repository secrets for GitHub Actions. Only returns secret names, not values.
GETget_repo_public_keyGet the public key for encrypting secrets. Required before creating or updating a secret.
PUTcreate_or_update_repo_secretCreate or update a repository secret. The encrypted_value must be encrypted with the repo's public key (from get_repo_public_key) using libsodium.
DELETEdelete_repo_secretDelete a repository secret.
GETlist_repo_variablesList repository variables for GitHub Actions.
POSTcreate_repo_variableCreate a repository variable for GitHub Actions.
PATCHupdate_repo_variableUpdate a repository variable.
DELETEdelete_repo_variableDelete a repository variable.
GETget_actions_permissionsGet GitHub Actions permissions for a repository: whether Actions is enabled and which actions are allowed.
PUTset_actions_permissionsEnable or disable GitHub Actions for a repository and set which actions may run. allowed_actions is all, local_only, or selected — use set_allowed_actions to define the selected set.
GETget_actions_workflow_permissionsGet the default GITHUB_TOKEN permissions for workflows in a repository, and whether workflows may approve pull requests.
PUTset_actions_workflow_permissionsSet the default GITHUB_TOKEN permissions for workflows. default_workflow_permissions is read or write; can_approve_pull_request_reviews allows workflows to approve PRs.
GETget_fork_pr_approval_policyGet which fork pull requests need manual approval before their workflows run. Critical for public repositories: without approval, a fork PR runs its own workflow file on your runners.
PUTset_fork_pr_approval_policySet which fork pull requests need manual approval before their workflows run. approval_policy is first_time_contributors_new_to_github, first_time_contributors, or all_external_contributors — the last is the strictest and the only safe choice for a public repo backed by self-hosted runners.
GETget_allowed_actionsGet the actions and reusable workflows allowed to run in a repository. Only meaningful when allowed_actions is set to selected.
PUTset_allowed_actionsSet which actions and reusable workflows may run when allowed_actions is selected. patterns_allowed takes entries like actions/checkout@* or monalisa/octocat@v2.
GETget_org_fork_pr_approval_policyGet the organization-wide policy for which fork pull requests need approval before their workflows run.
PUTset_org_fork_pr_approval_policySet the organization-wide policy for which fork pull requests need approval. approval_policy is first_time_contributors_new_to_github, first_time_contributors, or all_external_contributors. Applies to every repository in the org.
GETlist_repo_webhooksList webhooks for a repository.
GETget_repo_webhookGet a single webhook by ID.
POSTcreate_repo_webhookCreate a webhook for a repository. config.url is the payload URL. events is an array of event names (e.g. ['push', 'pull_request']).
PATCHupdate_repo_webhookUpdate a webhook. Only include fields you want to change.
DELETEdelete_repo_webhookDelete a webhook from a repository.
POSTping_repo_webhookSend a ping event to a webhook to test its configuration.
GETlist_deploymentsList deployments for a repository. Filter by sha, ref, task, or environment.
GETget_deploymentGet a single deployment.
POSTcreate_deploymentCreate a deployment. ref is the branch/tag/SHA to deploy. environment defaults to 'production'.
DELETEdelete_deploymentDelete a deployment. Only inactive deployments can be deleted.
GETlist_deployment_statusesList statuses for a deployment. States: error, failure, inactive, in_progress, queued, pending, success.
POSTcreate_deployment_statusCreate a deployment status. state: error, failure, inactive, in_progress, queued, pending, success.
GETlist_environmentsList deployment environments for a repository.
GETget_environmentGet a deployment environment by name.
PUTcreate_or_update_environmentCreate or update a deployment environment. Configure wait_timer (minutes), reviewers, and deployment_branch_policy.
DELETEdelete_environmentDelete a deployment environment.
GETlist_labelsList all labels for a repository.
GETget_labelGet a single label by name.
POSTcreate_labelCreate a label. Color is a 6-character hex code without '#' prefix (e.g. 'ff0000' for red).
PATCHupdate_labelUpdate a label. Only include fields you want to change. Use new_name to rename.
DELETEdelete_labelDelete a label from the repository.
GETlist_milestonesList milestones for a repository. State: open, closed, all.
GETget_milestoneGet a single milestone by its number, including open/closed issue counts.
POSTcreate_milestoneCreate a milestone. due_on is an ISO 8601 timestamp (e.g. '2026-04-01T00:00:00Z').
PATCHupdate_milestoneUpdate a milestone. Set state to 'closed' to close it. Only include fields you want to change.
DELETEdelete_milestoneDelete a milestone.
GETget_authenticated_userGet the currently authenticated user's profile including login, name, email, and bio.
GETget_userGet a public user profile by username.
GETlist_followersList followers of a user.
GETlist_followingList users that a user is following.
GETlist_tagsList tags for a repository, newest first. Each tag includes name and commit SHA.
GETlist_stargazersList users who have starred a repository.
GETlist_starred_reposList repositories starred by the authenticated user.
GETcheck_starredCheck if the authenticated user has starred a repo. Returns 204 if yes, 404 if no.
PUTstar_repoStar a repository for the authenticated user.
DELETEunstar_repoUnstar a repository for the authenticated user.
GETlist_watchersList users watching (subscribed to) a repository.
GETget_repo_subscriptionGet the authenticated user's subscription (watch status) for a repository.
PUTwatch_repoWatch a repository. Set subscribed=true to receive notifications, ignored=true to mute.
DELETEunwatch_repoStop watching a repository.
GETlist_gistsList gists for the authenticated user.
GETlist_public_gistsList public gists, newest first.
GETlist_starred_gistsList gists starred by the authenticated user.
GETget_gistGet a single gist by ID, including all files and their content.
POSTcreate_gistCreate a gist. files is a map of filename to {content: string}. Set public=true for a public gist.
PATCHupdate_gistUpdate a gist. To delete a file, set its value to null. To rename, delete the old name and create a new one.
DELETEdelete_gistDelete a gist.
GETlist_notificationsList notifications for the authenticated user. Set all=true to include read notifications.
PUTmark_notifications_readMark all notifications as read. Optionally provide last_read_at (ISO 8601) to only mark notifications before that time.
GETlist_repo_notificationsList notifications for a repository.
PUTmark_repo_notifications_readMark all notifications in a repository as read.
GETget_notification_threadGet a single notification thread.
PATCHmark_thread_readMark a notification thread as read.
GETlist_check_runs_for_refList check runs for a commit SHA, branch name, or tag. Filter by check_name, status, or filter (latest, all).
GETlist_check_run_annotationsList annotations for a check run. Returns inline lint/test errors with file path, line number, and message. Use this to inspect CI failure details programmatically.
GETlist_check_suites_for_refList check suites for a commit SHA, branch name, or tag.
GETget_combined_statusGet the combined status for a commit (aggregates all status checks). Returns state: success, failure, pending.
GETlist_commit_statusesList individual status checks for a commit ref.
POSTcreate_commit_statusCreate a commit status. state: error, failure, pending, success. Provide target_url for linking to CI details.
GETget_pagesGet GitHub Pages configuration for a repository.
POSTcreate_pages_siteEnable GitHub Pages for a repository. source.branch is the branch to publish from, source.path is '/' or '/docs'.
PUTupdate_pages_infoUpdate GitHub Pages configuration.
DELETEdelete_pages_siteDisable GitHub Pages for a repository.
GETlist_pages_buildsList GitHub Pages builds.
GETlist_code_scanning_alertsList code scanning alerts for a repository. State: open, closed, dismissed, fixed.
GETget_code_scanning_alertGet a single code scanning alert.
PATCHupdate_code_scanning_alertUpdate a code scanning alert. Set state to 'dismissed' with a dismissed_reason, or 'open' to reopen.
GETlist_dependabot_alertsList Dependabot alerts for a repository. State: auto_dismissed, dismissed, fixed, open.
GETget_dependabot_alertGet a single Dependabot alert.
PATCHupdate_dependabot_alertUpdate a Dependabot alert. Set state to 'dismissed' with a dismissed_reason, or 'open' to reopen.
GETlist_secret_scanning_alertsList secret scanning alerts for a repository. State: open, resolved.
GETget_secret_scanning_alertGet a single secret scanning alert.
PATCHupdate_secret_scanning_alertUpdate a secret scanning alert. Set state to 'resolved' with a resolution (false_positive, wont_fix, revoked, used_in_tests, pattern_edited, pattern_deleted).
GETlist_org_packagesList packages in an organization. package_type is required: npm, maven, rubygems, docker, nuget, container.
GETget_org_packageGet a specific package in an organization.
DELETEdelete_org_packageDelete an entire package in an organization. Requires admin permissions. Cannot be undone after 30 days.
POSTrestore_org_packageRestore a deleted organization package. Only works within 30 days of deletion.
GETlist_org_package_versionsList all versions of an organization package. Filter by state: active (default), deleted.
GETget_org_package_versionGet a specific version of an organization package.
DELETEdelete_org_package_versionDelete a specific version of an organization package. Cannot be undone after 30 days.
POSTrestore_org_package_versionRestore a deleted version of an organization package. Only works within 30 days.
GETlist_user_packagesList packages owned by the authenticated user. package_type is required: npm, maven, rubygems, docker, nuget, container.
GETget_user_packageGet a package owned by the authenticated user.
DELETEdelete_user_packageDelete a package owned by the authenticated user. Cannot be undone after 30 days.
GETlist_user_package_versionsList all versions of a package owned by the authenticated user.
DELETEdelete_user_package_versionDelete a specific version of a package owned by the authenticated user.
GETget_issue_parentGet the parent issue of a sub-issue. Returns the full parent issue object, or 404 if the issue has no parent.
GETlist_sub_issuesList the sub-issues of an issue, in their manual priority order. Returns full issue objects.
POSTadd_sub_issueAdd a sub-issue under a parent issue. sub_issue_id is the database id (the 'id' field of get_issue), NOT the issue_number. Set replace_parent=true to move a sub-issue that already belongs to a different parent.
DELETEremove_sub_issueRemove a sub-issue from its parent. Note the singular 'sub_issue' in the path. sub_issue_id is the database id, not the issue_number. Only the parent/child link is removed — the issue itself is not deleted.
PATCHreprioritize_sub_issueReorder a sub-issue within its parent's list. Provide after_id OR before_id (another sub-issue's database id) to position it — they are mutually exclusive. sub_issue_id is the database id of the sub-issue being moved.
GETlist_issue_blocked_byList the issues that block the given issue (its 'blocked by' dependencies). Returns full issue objects.
POSTadd_issue_blocked_byMark issue_number as blocked by another issue. issue_id (body) is the database id (the 'id' field of get_issue) of the blocking issue, NOT its issue_number.
DELETEremove_issue_blocked_byRemove a 'blocked by' dependency. issue_id (path) is the database id of the blocking issue. Only the dependency link is removed; neither issue is deleted.
GETlist_issue_blockingList the issues that the given issue is blocking (the inverse of blocked_by). Returns full issue objects.
GETlist_issue_typesList the issue types defined for an organization (id, name, description, color, is_enabled). Assign one to an issue via the `type` field of create_issue/update_issue.
POSTcreate_issue_typeCreate a new issue type for an organization. color is one of gray, blue, green, yellow, orange, red, pink, purple (or null).
PUTupdate_issue_typeUpdate an organization issue type. The API requires name and is_enabled even for partial edits — resend the current values for fields you are not changing.
DELETEdelete_issue_typeDelete an organization issue type. Any issues currently using it lose their type.
GETlist_repo_rulesetsList the rulesets for a repository. includes_parents=true (default) also returns inherited org-level rulesets. targets filters by comma-separated target types (branch,tag,push).
GETget_repo_rulesetGet a single repository ruleset by id, including its full rules and conditions.
POSTcreate_repo_rulesetCreate a repository ruleset. enforcement is one of disabled, active, evaluate. target is branch (default), tag, or push. rules is an array of rule objects, each with a `type` (e.g. pull_request, required_status_checks, required_signatures, non_fast_forward, commit_message_pattern, required_linear_history) and an optional `parameters` object. bypass_actors is an array of {actor_id, actor_type (Team|Integration|RepositoryRole|OrganizationAdmin|DeployKey|User), bypass_mode (always|pull_request)}. conditions is {ref_name:{include:[...], exclude:[...]}}; refs use refs/heads/* or the ~DEFAULT_BRANCH / ~ALL placeholders.
PUTupdate_repo_rulesetUpdate a repository ruleset. Same writable fields as create_repo_ruleset; send only the fields you want to change (each provided field replaces its previous value).
DELETEdelete_repo_rulesetDelete a repository ruleset. Removes the policy and its protections immediately.
GETget_branch_rulesGet the effective rules that apply to a branch, aggregated across all active rulesets (repo + inherited org). Each entry names the rule type and the ruleset it comes from.
GETlist_repo_rule_suitesList rule evaluation runs (rule suites) for a repository — the audit log of ruleset enforcement. Filter by ref, time_period (hour|day|week|month), actor_name, rule_suite_result (pass|fail|bypass|all), evaluate_status (all|active|evaluate).
GETget_repo_rule_suiteGet a single repository rule suite (one evaluation run), including the per-rule pass/fail/bypass results.
GETlist_org_rulesetsList all organization-level rulesets. targets filters by comma-separated target types (branch,tag,push,repository).
GETget_org_rulesetGet a single organization ruleset by id, including rules and conditions.
POSTcreate_org_rulesetCreate an organization ruleset. enforcement is disabled|active|evaluate. target is branch (default), tag, push, or repository. conditions may target refs (ref_name) and repositories (repository_name:{include,exclude}, repository_id, or repository_property to match custom properties). rules and bypass_actors have the same shape as repository rulesets — see create_repo_ruleset.
PUTupdate_org_rulesetUpdate an organization ruleset. Same writable fields as create_org_ruleset; send only the fields you want to change.
DELETEdelete_org_rulesetDelete an organization ruleset. Removes the policy from every targeted repository immediately.
GETlist_org_rule_suitesList rule evaluation runs (rule suites) across an organization's repositories — the org-wide enforcement audit log. Filter by repository_name, ref, time_period (hour|day|week|month), actor_name, rule_suite_result (pass|fail|bypass|all), evaluate_status (all|active|evaluate).
GETget_org_rule_suiteGet a single organization rule suite (one evaluation run), including per-rule pass/fail/bypass results.
GETget_org_properties_schemaList all custom property definitions for an organization (property_name, value_type, required, allowed_values, default_value).
PATCHset_org_properties_schemaCreate or update multiple custom property definitions in one call. properties is an array of objects: {property_name (required), value_type (string|single_select|multi_select|true_false, required), required (bool), default_value, description, allowed_values, values_editable_by (org_actors|org_and_repo_actors)}.
GETget_org_propertyGet a single custom property definition by name.
PUTset_org_propertyCreate or update a single custom property definition. value_type is string, single_select, multi_select, or true_false.
DELETEremove_org_propertyRemove a custom property definition from an organization. Also clears that property's values on all repositories.
GETlist_org_property_valuesList custom property values assigned to repositories across the org. repository_query filters repos using GitHub search syntax.
PATCHset_org_property_valuesAssign custom property values to a list of repositories in one call. repository_names is an array of repo names (max 30 per call). properties is an array of {property_name, value} — value is a string, an array (multi_select), or null to clear.
GETget_repo_property_valuesGet all custom property values set on a single repository. Returns an array of {property_name, value}.
PATCHset_repo_property_valuesCreate or update custom property values on a single repository. properties is an array of {property_name, value}; value=null removes the property from the repo.
GETget_traffic_viewsGet page-view counts for the last 14 days. per is 'day' (default) or 'week'. Returns total count, uniques, and a per-period breakdown. Requires push access.
GETget_traffic_clonesGet git clone counts for the last 14 days. per is 'day' (default) or 'week'. Returns total count, uniques, and a per-period breakdown. Requires push access.
GETlist_traffic_pathsGet the top 10 most-visited content paths over the last 14 days (path, title, count, uniques). Requires push access.
GETlist_traffic_referrersGet the top 10 referrer sources over the last 14 days (referrer, count, uniques). Requires push access.
GETget_stats_contributorsPer-contributor commit stats: total commits plus weekly added/deleted/commits buckets (w = week start, epoch seconds). Returns 202 on a cold cache — retried automatically.
GETget_stats_commit_activityLast 52 weeks of commit activity: per week {total, week (epoch seconds), days[7] from Sun..Sat}. Returns 202 on a cold cache — retried automatically.
GETget_stats_code_frequencyWeekly additions/deletions as an array of [week (epoch seconds), additions, deletions (negative)]. Returns 202 on a cold cache — retried automatically.
GETget_stats_participationLast 52 weeks of commit counts as {all:[...], owner:[...]} (oldest first). Returns 200 with data; may briefly return 202 on a cold cache.
GETget_stats_punch_cardCommit counts per weekday/hour as an array of [day (0=Sun..6=Sat), hour (0-23), commits]. Returns 200 with data; may briefly return 202 on a cold cache.