> ## Documentation Index > Fetch the complete documentation index at: https://docs.boxd.sh/llms.txt > Use this file to discover all available pages before exploring further. # GitHub > GitHub is a code hosting platform for version control and collaboration, offering Git-based repository management, issue tracking, and continuous integration features GitHub is a code hosting platform for version control and collaboration, offering Git-based repository management, issue tracking, and continuous integration features `github` · **893 tools** · **46 triggers** ## Connect it ```bash theme={"theme":"github-dark"} run auth github run auth github --scope team # shared with the organization ``` Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one. ## Use it ```bash theme={"theme":"github-dark"} run github # common commands run github --all # every command ``` ```ts theme={"theme":"github-dark"} import { github } from "@boxd/run"; ``` ## Common tools | Tool | What it does | | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `add-repository-collaborator` | Adds a GitHub user as a repository collaborator, or updates their permission if already a collaborator; `permission` applies to organization-owned... | | `add-assignees-to-issue` | Adds assignees to a GitHub issue. This action only adds users - it does not remove existing assignees. | | `add-email-address-for-authenticated-user` | Adds one or more email addresses (which will be initially unverified) to the authenticated user's GitHub account; use this to associate new emails... | | `add-labels-to-issue` | Adds labels (provided in the request body) to a repository issue; labels that do not already exist are created. | | `add-or-update-team-membership-for-user` | Adds a GitHub user to a team or updates their role (member or maintainer), inviting them to the organization if not already a member; idempotent... | | `approve-workflow-run-for-fork-pull-request` | Approves a workflow run from a forked repository's pull request; call this when such a run requires manual approval due to workflow configuration. | | `check-if-pull-request-merged` | Checks if a pull request has been merged by querying the GitHub API. | | `close-issue` | Close a GitHub issue by setting its state to closed. Use this action when you need to mark an issue as resolved or no longer relevant. | | `close-pull-request` | Closes an open pull request without merging it. The pull request state is set to "closed" and it can be reopened later if needed. | | `commit-multiple-files` | Tool to atomically create, update, or delete multiple files in a GitHub repository as a single commit. | | `compare-two-commits` | Compares two commit points (commits, branches, tags, or SHAs) within a repository or across forks, using `BASE...HEAD` or `OWNER:REF...OWNER:REF`... | | `create-blob` | Creates a Git blob in a repository, requiring content and encoding ('utf-8' or 'base64'). | | `create-commit` | Creates a new commit in a GitHub repository; the `tree` SHA and any `parents` SHAs must already exist in the repository. | | `create-issue` | Creates a new issue in a GitHub repository, requiring the repository to exist and have issues enabled; specific fields like assignees, milestone, or... | | `create-issue-comment` | Creates a new comment on an existing GitHub issue or pull request within the specified repository. | | `create-organization-repository` | Creates a new repository within a specified GitHub organization, with options for detailed configuration including visibility, features, merge... | | `create-pull-request` | Creates a pull request in a GitHub repository, requiring existing `base` and `head` branches; `title` or `issue` must be provided. | | `create-reference` | Creates a NEW Git reference (branch or tag) in a repository. | | `create-release` | Creates a release in a GitHub repository for a specified tag; the tag must be unique for published releases, and if a `discussion_category_name` is... | | `create-tree` | Creates a new Git tree object in a repository, defining file/directory structure by specifying tree entries, optionally building on a `base_tree`... | | `create-branch` | Creates a new branch in a GitHub repository pointing to a specified commit. | | `create-draft-item-for-user-project` | Creates a draft issue item in a user-owned GitHub ProjectsV2. | | `create-or-update-file-contents` | Creates a new file or updates an existing file in a GitHub repository; SHA can be provided to validate file updates, automatically fetched if not provided. | | `create-repository` | Creates a new repository for the authenticated user. Use this action when you need to create a new GitHub repository under the authenticated user's account. | | `delete-repository` | Permanently deletes the specified repository; this is a destructive, irreversible action that requires admin privileges for the repository. | | Tool | What it does | | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `abort-repository-migration` | Tool to abort a repository migration that is queued or in progress. | | `accept-repository-invitation` | Accepts a PENDING repository invitation that has been issued to the authenticated user. | | `add-app-access-restrictions` | Adds GitHub Apps to the list of apps allowed to push to a protected branch. | | `add-repository-collaborator` | Adds a GitHub user as a repository collaborator, or updates their permission if already a collaborator; `permission` applies to organization-owned... | | `add-assignees-to-issue` | Adds assignees to a GitHub issue. This action only adds users - it does not remove existing assignees. | | `add-email-address-for-authenticated-user` | Adds one or more email addresses (which will be initially unverified) to the authenticated user's GitHub account; use this to associate new emails... | | `add-field-to-user-project` | Tool to add a custom field to a user-owned GitHub Projects V2 project. | | `add-item-to-user-project` | Tool to add an issue or pull request to a user-owned GitHub project. | | `add-labels-to-issue` | Adds labels (provided in the request body) to a repository issue; labels that do not already exist are created. | | `add-org-runner-labels` | Adds new custom labels to an existing self-hosted runner for an organization; existing labels are not removed, and duplicates are not added. | | `add-or-update-team-membership-for-user` | Adds a GitHub user to a team or updates their role (member or maintainer), inviting them to the organization if not already a member; idempotent... | | `add-or-update-team-project-permissions` | Adds a classic project to a team or updates the team's permission on it. | | `add-or-update-team-repository-permissions` | Sets or updates a team's permission level for a repository within an organization; the team must be a member of the organization. | | `add-project-collaborator` | Adds a specified GitHub user as a collaborator to an existing organization project with a given permission level. | | `add-repository-to-app-installation` | Adds a repository to a GitHub App installation, granting the app access; requires authenticated user to have admin rights for the repository and... | | `add-repo-to-org-secret-with-selected-access` | Adds a repository to an existing organization-level GitHub Actions secret that is configured for 'selected' repository access. | | `add-repo-to-org-secret-with-selected-visibility` | Grants an existing repository access to an existing organization-level Dependabot secret when the secret's visibility is set to 'selected'; the... | | `add-runner-labels` | Adds and appends custom labels to a self-hosted repository runner, which must be registered and active. | | `add-selected-repository-to-organization-secret` | Adds a repository to an organization secret's access list when the secret's visibility is 'selected'; this operation is idempotent. | | `add-selected-repository-to-organization-variable` | Grants a repository access to an organization-level GitHub Actions variable, if that variable's visibility is set to 'selected\_repositories'. | | `add-selected-repository-to-user-secret` | Grants a specified repository access to an authenticated user's existing Codespaces secret, enabling Codespaces created for that repository to use the secret. | | `add-social-accounts-for-authenticated-user` | Adds one or more social media links (which must be valid, full URLs for platforms supported by GitHub) to the authenticated user's public GitHub profile. | | `add-status-check-contexts` | Adds status check contexts to a protected branch's required status checks. | | `add-sub-issue` | Tool to add a sub-issue to a parent GitHub issue using GraphQL. | | `add-team-access-restrictions` | Adds teams to the list of teams with push access to a protected branch. | | `add-user-access-restrictions` | Adds users to the list of people allowed to push to a protected branch in an organization repository. | | `add-users-to-codespaces-access-for-organization` | Adds organization members to the list of users granted Codespaces access billed to the organization. | | `api-root` | Retrieves a map of all top-level GitHub REST API resource URLs and their templates. | | `approve-workflow-run-for-fork-pull-request` | Approves a workflow run from a forked repository's pull request; call this when such a run requires manual approval due to workflow configuration. | | `assign-organization-role-to-team` | Assigns an existing organization-level role (identified by `role_id`) to a team (identified by `team_slug`) within a GitHub organization (`org`)... | | `assign-organization-role-to-user` | Assigns a specific organization role to a user who is a member or an outside collaborator in a GitHub organization, using a valid role ID. | | `auth-user-docker-conflict-packages-list` | List Docker packages with migration conflicts for the authenticated user. | | `block-user` | Blocks an existing individual GitHub user (not an organization or your own account), preventing them from interacting with your account and repositories. | | `block-user-from-organization` | Blocks a GitHub user from an organization, preventing their contributions, collaboration, and forking of the organization's repositories. | | `cancel-pages-deployment` | Cancels an existing, ongoing or queued GitHub Pages deployment for a repository using its `pages_deployment_id`. | | `cancel-sponsorship` | Tool to cancel an active GitHub sponsorship using GraphQL. Use when you need to terminate a sponsorship relationship between a sponsor and a sponsorable entity. | | `cancel-workflow-run` | Cancels a workflow run in a GitHub repository if it is in a cancellable state (e.g., 'in\_progress' or 'queued'). | | `check-following` | Check if the authenticated user is following a specified person on GitHub. | | `check-if-gist-is-starred` | Checks if a gist is starred by the authenticated user. Returns `is_starred: true` if the gist is starred (HTTP 204), or `is_starred: false` if not starred (HTTP 404). | | `check-if-pull-request-has-been-merged` | Checks if a specified GitHub pull request has been merged, indicated by a 204 HTTP status (merged) or 404 (not merged/found). | | `check-if-pull-request-merged` | Checks if a pull request has been merged by querying the GitHub API. | | `check-if-repo-starred-by-auth-user` | DEPRECATED: Use `GITHUB_CHECK_IF_A_REPOSITORY_IS_STARRED_BY_THE_USER` instead. | | `check-if-user-can-be-assigned` | Verifies if a GitHub user can be assigned to issues in a repository; assignability is confirmed by an HTTP 204 (No Content) response, resulting in an... | | `check-if-user-can-be-assigned-to-issue` | Checks if a specified GitHub user can be assigned to a given issue within a repository. | | `check-if-user-follows-another-user` | Checks if a GitHub user `username` follows `target_user`; returns a 204 HTTP status if true, 404 if not or if users are invalid. | | `check-if-user-is-blocked-by-authenticated-user` | Checks if the specified GitHub user is blocked by the authenticated user; a 204 No Content response indicates the user is blocked, while a 404 Not... | | `check-if-user-is-blocked-by-organization` | Checks if a GitHub user is blocked by an organization. Returns is\_blocked=True if the user is blocked (HTTP 204), or is\_blocked=False if not blocked (HTTP 404). | | `check-if-user-is-repository-collaborator` | Checks if a user is a collaborator on a specified GitHub repository, returning a 204 status if they are, or a 404 status if they are not or if the... | | `check-person-followed-by-auth-user` | Checks if the authenticated GitHub user follows a target GitHub user. | | `check-private-vulnerability-reporting-status` | Checks if private vulnerability reporting is enabled for the specified repository. | | `check-public-organization-membership-for-user` | Tool to check if a user is a public member of an organization. | | `check-repository-starred` | Check if a repository is starred by the authenticated user. Use this action when you need to verify whether the authenticated user has starred a specific repository. | | `check-team-permissions-for-project` | Checks if a team has 'read', 'write', or 'admin' permissions for an organization's specific classic project, returning the project's details if access is confirmed. | | `check-team-permissions-for-repository` | Checks a team's permissions for a specific repository within an organization, including permissions inherited from parent teams. | | `check-token` | Checks if a GitHub App or OAuth access\_token is valid for the specified client\_id and retrieves its details, typically to verify its active status and grants. | | `clear-project-v2-item-field-value` | Tool to clear the value of a field for an item in a GitHub Project V2. | | `clear-repository-cache-by-key` | Deletes GitHub Actions caches from a repository matching a specific `key` and an optional Git `ref`, used to manage storage or clear... | | `clear-self-hosted-runner-org-labels` | Removes all custom labels from a self-hosted runner for an organization; default labels (e.g., 'self-hosted', 'linux', 'x64') will remain. | | `close-issue` | Close a GitHub issue by setting its state to closed. Use this action when you need to mark an issue as resolved or no longer relevant. | | `close-pull-request` | Closes an open pull request without merging it. The pull request state is set to "closed" and it can be reopened later if needed. | | `commit-multiple-files` | Tool to atomically create, update, or delete multiple files in a GitHub repository as a single commit. | | `compare-two-commits` | Compares two commit points (commits, branches, tags, or SHAs) within a repository or across forks, using `BASE...HEAD` or `OWNER:REF...OWNER:REF`... | | `configure-jit-runner-for-org` | Generates a JIT configuration for a GitHub organization's new self-hosted runner to run a single job then unregister; requires admin:org scope and... | | `configure-oidc-subject-claim-template` | Sets or updates the OIDC subject claim customization template for an existing GitHub organization by specifying which claims (e.g., 'repo', 'actor')... | | `convert-org-member-to-outside-collaborator` | Converts an existing organization member, who is not an owner, to an outside collaborator, restricting their access to explicitly granted repositories. | | `convert-pull-request-to-draft` | Converts an open pull request to draft status, indicating it is not ready for review. | | `create-blob` | Creates a Git blob in a repository, requiring content and encoding ('utf-8' or 'base64'). | | `create-check-run` | Creates a new check run for a specific commit in a repository, used by external services to report status, detailed feedback, annotations, and images... | | `create-check-suite` | Creates a new check suite for a specific commit (`head_sha`) in an original repository (not a fork). | | `create-codespace-for-authenticated-user` | Creates a GitHub Codespace for the authenticated user, requiring a JSON request body with either `repository_id` (integer) or a `pull_request` object... | | `create-codespace-from-pull-request` | Creates a GitHub Codespace for an open pull request in a Codespaces-enabled repository, with options to customize its configuration. | | `create-codespace-in-repository` | Creates a GitHub Codespace for the authenticated user in a specified repository, which must be accessible and use a valid `devcontainer.json` if... | | `create-commit` | Creates a new commit in a GitHub repository; the `tree` SHA and any `parents` SHAs must already exist in the repository. | | `create-commit-comment` | Creates a comment on a specific commit, or on a specific line if `path` and `position` are provided. | | `create-commit-status` | Sets a commit's status (e.g., error, failure, pending, success from CI/CD) for a given SHA; max 1000 statuses per SHA/context. | | `create-custom-organization-role` | Creates a custom role with defined permissions within a GitHub organization. | | `create-deploy-key` | Creates a deploy key for a repository; the repository must exist and be accessible, and the provided key must be a valid public SSH key. | | `create-deployment` | Creates a GitHub deployment for an existing repository, targeting a specific ref (branch, tag, or SHA) that must also exist within the repository. | | `create-deployment-branch-policy` | Creates a deployment branch or tag policy for an existing environment in a GitHub repository, using a Ruby File.fnmatch pattern (where `*` doesn't... | | `create-deployment-status` | Creates a status for an existing deployment, updating its operational state, associated URLs, and description. | | `create-discussion` | Creates a new discussion post on a specific team's page within an organization. | | `create-discussion-comment` | Creates a new comment on an existing team discussion within a GitHub organization. | | `create-fork` | Creates a fork of an accessible repository, optionally into a specific organization, with a new name, or copying only the default branch. | | `create-gist` | Creates a new gist on GitHub with provided files, an optional description, and public/secret visibility. | | `create-gist-comment` | Creates a new comment on a specified GitHub gist. | | `create-app-from-manifest` | Use this action to complete the GitHub App Manifest flow (step 3 of 3) by exchanging the temporary authorization `code` for the app's full... | | `create-pages-deployment` | Creates a GitHub Pages deployment for a repository using a specified artifact and OIDC token, provided GitHub Pages is enabled and the artifact... | | `create-pages-site` | Configures or updates GitHub Pages for a repository, setting build type and source; ensure a Pages workflow exists for 'workflow' `build_type`, or... | | `create-label` | Creates a new label in a specified GitHub repository, provided the repository exists and the user has write permissions. | | `create-milestone` | Creates a milestone in a GitHub repository for tracking progress on issues or pull requests; requires repository existence and user write permissions. | | `create-autolink-reference-for-repository` | Creates a repository autolink to automatically convert text references (e.g., 'TICKET-123') into hyperlinks, using a unique `key_prefix` and a... | | `create-environment-variable` | Creates an encrypted environment variable for a pre-existing environment within a GitHub repository; will fail if the variable name already exists. | | `create-issue` | Creates a new issue in a GitHub repository, requiring the repository to exist and have issues enabled; specific fields like assignees, milestone, or... | | `create-issue-comment` | Creates a new comment on an existing GitHub issue or pull request within the specified repository. | | `create-organization-project` | Creates a new classic project board within a specified GitHub organization. | | `create-organization-repository` | Creates a new repository within a specified GitHub organization, with options for detailed configuration including visibility, features, merge... | | `create-organization-variable` | Creates a new, uniquely named GitHub Actions variable for an organization, with configurable repository access visibility (all, private, or selected). | | `create-organization-webhook` | Creates a webhook for a GitHub organization to deliver event notifications to a configured URL. | | `create-project-card` | Creates a project card in a GitHub project column (classic projects only). | | `create-project-column` | Creates a new column in a GitHub project (classic). DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. | | `create-pull-request` | Creates a pull request in a GitHub repository, requiring existing `base` and `head` branches; `title` or `issue` must be provided. | | `create-reference` | Creates a NEW Git reference (branch or tag) in a repository. | | `create-registration-token-for-organization` | Generates a temporary (one-hour) registration token to add a new self-hosted runner to an organization for GitHub Actions. | | `create-registration-token-for-repository` | Generates a time-limited token required to register a new self-hosted runner with a specific repository. | | `create-release` | Creates a release in a GitHub repository for a specified tag; the tag must be unique for published releases, and if a `discussion_category_name` is... | | `create-remove-token-for-organization` | Generates a token, valid for one hour, to authenticate removing a self-hosted runner from an organization. | | `create-remove-token-for-repository` | Generates a temporary (one-hour validity) token required to unregister and remove a self-hosted runner from a repository. | | `create-reply-for-review-comment` | Posts a reply to a specific review comment on a GitHub pull request, requiring the repository, pull request, and original comment to exist, and a non-empty reply body. | | `create-repository-dispatch-event` | Triggers a GitHub Actions workflow or a webhook on a repository by creating a repository dispatch event, allowing programmatic triggering of... | | `create-repository-for-authenticated-user` | Creates a new repository for the authenticated user, optionally within an organization if `team_id` is specified. | | `create-repository-from-unpublished-codespace` | Publishes the specified codespace to a new repository, using the codespace's current state as the initial commit. | | `create-repository-project` | Creates a new GitHub Projects V2 project board linked to a specified repository. | | `create-repository-ruleset` | Creates a uniquely named ruleset for a repository, defining rules for branches or tags with specified enforcement, conditions, and bypass actors. | | `create-repository-using-template` | Creates a new repository from an existing template repository; the authenticated user must have access to the template and, if creating in an... | | `create-repository-variable` | Creates a new, unencrypted variable in a repository for GitHub Actions workflows; fails if a variable with the same name already exists. | | `create-repository-webhook` | Creates a webhook for a specified repository; requires admin permissions on the repository. | | `create-review-comment-for-pull-request` | Creates a review comment on a pull request's diff, targeting a specific line, range of lines, an entire file, or replying to an existing comment. | | `create-review-for-pull-request` | Creates a pull request review, allowing approval, change requests, or comments; `body` is required if `event` is `REQUEST_CHANGES` or `COMMENT`, and... | | `create-scoped-access-token` | Exchanges a user-to-server token for a new, fine-grained scoped access token for a GitHub App, requiring `client_id`, `access_token`, either `target`... | | `create-snapshot-of-dependencies-for-repository` | Creates a snapshot of a repository's dependencies to populate the GitHub dependency graph and enable security alerts; `sha` must be a 40-character... | | `create-tag-object` | Creates an annotated Git tag object in a repository, pointing to an existing Git object (commit, tree, or blob) defined by its SHA and ensuring the... | | `create-tag-protection-state-for-repository` | DEPRECATED: This API was sunset on August 30, 2024. Use GITHUB\_CREATE\_REPOSITORY\_RULESET instead to create tag protection rules via repository rulesets. | | `create-team` | Creates a new team in an organization, optionally with maintainers, repositories, specific privacy, notification settings, or a parent team; if... | | `create-temporary-private-fork` | Creates a temporary private fork of the specified repository to address a security vulnerability, linking the fork to a GHSA ID that must be... | | `create-tree` | Creates a new Git tree object in a repository, defining file/directory structure by specifying tree entries, optionally building on a `base_tree`... | | `create-user-project` | Creates a new GitHub Projects V2 project board for the authenticated user to organize and track issues, pull requests, and notes. | | `create-workflow-dispatch-event` | Manually triggers a GitHub Actions workflow identified by `workflow_id` at a given `ref`, if the workflow is configured to accept `workflow_dispatch` events. | | `create-branch` | Creates a new branch in a GitHub repository pointing to a specified commit. | | `create-commit-signature-protection` | Enables commit signature protection for a specified branch, requiring all new commits to be signed. | | `create-deployment-protection-rule` | Enables a custom deployment protection rule for an existing environment in a repository by linking a configured GitHub App (via `integration_id`) to control deployments. | | `create-draft-item-for-user-project` | Creates a draft issue item in a user-owned GitHub ProjectsV2. | | `create-inference-chat-completions` | Tool to create chat completions using GitHub Models inference API. | | `create-inference-embeddings` | Tool to create inference embeddings using GitHub's AI models. | | `create-issue-type` | Create a new issue type for a GitHub organization. Requires the authenticated user to be an organization administrator. | | `create-jit-runner-config` | Generates a temporary Just-In-Time (JIT) configuration for a new self-hosted GitHub Actions runner for a repository; any specified non-default... | | `create-or-update-environment` | Creates a new environment or updates an existing one in a GitHub repository, allowing configuration of deployment protection rules such as wait... | | `create-or-update-environment-secret` | Creates or updates an environment secret with an `encrypted_value` that was encrypted using the public key identified by `key_id` for the specified environment. | | `create-or-update-organization-secret` | Creates or updates an organization secret for GitHub Actions, requiring its value to be pre-encrypted via LibSodium using the organization's public key. | | `create-or-update-repository-secret` | Creates or updates a GitHub Actions secret within a specific repository; use `encrypted_value` and `key_id` to set or change its value. | | `create-or-update-secret-for-authenticated-user` | Creates or updates a Codespaces secret for the authenticated user; `encrypted_value` must be encrypted with the public key (ID: `key_id`) from... | | `create-or-update-custom-properties-for-org` | Creates new custom property schemas or updates existing ones in bulk for a specified organization; each property definition must include `property_name` and `value_type`. | | `create-or-update-custom-property-org` | Creates a new custom property (name must be unique for creation) or updates an existing one for an organization to define metadata for its repositories. | | `create-or-update-file-contents` | Creates a new file or updates an existing file in a GitHub repository; SHA can be provided to validate file updates, automatically fetched if not provided. | | `create-or-update-pages-site` | Tool to enable or update GitHub Pages configuration for a repository. | | `create-or-update-repo-secret-with-encrypted-value` | Creates or updates a Dependabot secret in a repository using an `encrypted_value` (pre-encrypted with LibSodium using the repository's Dependabot... | | `create-reaction-for-commit-comment` | Creates an emoji reaction for a commit comment; if the user has already reacted with the same content, details of the existing reaction are returned. | | `create-reaction-for-issue` | Creates a reaction for a specified issue within a GitHub repository. | | `create-reaction-for-issue-comment` | Creates a reaction for a specific comment on an issue within a GitHub repository. | | `create-reaction-for-pull-request-review-comment` | Adds a specified reaction to a pull request review comment within a GitHub repository. | | `create-reaction-for-release` | Creates an emoji reaction for a specific, existing release in a GitHub repository. | | `create-reaction-for-team-discussion` | Creates a reaction for a team discussion within a GitHub organization. | | `create-reaction-for-team-discussion-comment` | Adds a reaction to a team discussion comment, requiring the specified organization, team, discussion, and comment to exist. | | `create-repository` | Creates a new repository for the authenticated user. Use this action when you need to create a new GitHub repository under the authenticated user's account. | | `create-sponsorship` | Tool to start a new GitHub sponsorship or reactivate a past sponsorship using GraphQL. | | `create-sponsors-tier` | Tool to create a new payment tier for your GitHub Sponsors profile using GraphQL. | | `create-update-org-secret-with-lib-sodium` | Creates or updates a Dependabot organization secret, requiring the secret value to be pre-encrypted with LibSodium using the organization's public... | | `create-user-list` | Tool to create a new user list on GitHub. Use when you need to organize and group GitHub users for easier tracking and management. | | `create-view-for-user-project` | Tool to create a new view in a user-owned GitHub project (Projects V2). | | `decline-repository-invitation` | Declines a specific, pending repository invitation for the authenticated user, identified by its `invitation_id`. | | `delete-access-restrictions` | Removes all user, team, and app-based access restrictions from a protected branch. | | `delete-admin-branch-protection` | Removes admin enforcement from a protected branch (branch name cannot contain wildcard characters) in a repository. | | `delete-file` | Deletes a file by path from a GitHub repository. The file's blob SHA is automatically fetched if not provided. | | `delete-package-version-for-authenticated-user` | Deletes an existing package version associated with the authenticated user. | | `delete-app-authorization` | Deletes an OAuth application grant for a user, which revokes ALL OAuth tokens and their associated authorizations for the application. | | `delete-app-token` | Revokes a single OAuth access token for an OAuth App or GitHub App with OAuth authorization. | | `delete-reference` | Deletes a Git reference from a repository; 'ref' must be fully qualified (e.g., 'refs/heads/branch' or 'refs/tags/tag'). | | `delete-release` | Permanently deletes a specific release, its assets, and potentially its associated Git tag from a repository. | | `delete-release-asset` | Deletes a specific release asset from a GitHub repository; this action is idempotent. | | `delete-release-reaction` | Deletes a reaction from a GitHub release, provided the repository, release, and reaction exist. | | `delete-repository` | Permanently deletes the specified repository; this is a destructive, irreversible action that requires admin privileges for the repository. | | `delete-repository-invitation` | Deletes an active repository invitation, permanently revoking a user's access to collaborate on the specified repository. | | `delete-repository-ruleset` | Permanently deletes a repository ruleset. | | `delete-repository-secret` | Deletes a named GitHub Actions secret from a specified repository; this operation is destructive and idempotent, and requires the repository to exist. | | `delete-repository-subscription` | Deletes the authenticated user's subscription to a specified repository if it exists, effectively 'unwatching' it. | | `delete-repository-variable` | Deletes a named variable (e.g., for GitHub Actions workflows) from a repository; the repository and the variable must already exist. | | `delete-repository-webhook` | Deletes a specific webhook from a repository. | | `delete-review-comment-for-pull-request` | Deletes a specific pull request review comment. | | `delete-artifact` | Deletes a GitHub artifact by its ID within a repository, typically resulting in an empty response (HTTP 204 No Content) on success. | | `delete-secret-for-authenticated-user` | Deletes an existing Codespaces secret for the authenticated user by `secret_name`. | | `delete-self-hosted-runner-from-organization` | Forces the removal of a self-hosted runner from a GitHub organization. | | `delete-self-hosted-runner-from-repository` | Removes a specific self-hosted runner (by `runner_id`) from a repository, if registered there; this is idempotent. | | `delete-tag-protection-state-for-repository` | DEPRECATED: This API was sunset on August 30, 2024. Use GITHUB\_DELETE\_REPOSITORY\_RULESET instead to manage tag protection rules via repository rulesets. | | `delete-team` | Deletes a team (and any child teams) from an organization. | | `delete-thread-subscription` | Call this to mute a specific notification thread by deleting the user's subscription; notifications may still occur if the user is @mentioned... | | `delete-autolink-reference` | Deletes a specific autolink reference (which automatically links external resource IDs like JIRA-123 to URLs) from the specified repository. | | `delete-workflow-run` | Deletes a specific workflow run from a repository. | | `delete-branch-protection` | Removes all protection rules from a specific branch in a GitHub repository; the branch must currently have protection rules enabled. | | `delete-code-scanning-analysis` | Deletes a specific code scanning analysis by its ID from a repository; `confirm_delete` must be `true` if it's the last analysis of its type for a... | | `delete-codespace` | Deletes a specific codespace owned by the authenticated user; this is a destructive action and the codespace must exist. | | `delete-commit-comment` | Deletes a specific commit comment, identified by its `comment_id`, from the specified repository; the comment must exist. | | `delete-commit-comment-reaction` | Deletes a reaction from a commit comment in a GitHub repository. | | `delete-commit-signature-protection` | Disables GPG commit signature protection for a specific branch in a GitHub repository, meaning commits pushed to this branch no longer require GPG signing. | | `delete-custom-organization-role` | Deletes a custom organization role (which should not be actively assigned) by its ID; a 204 No Content response indicates success. | | `delete-dependebot-secret-by-name` | Deletes a specific Dependabot secret, identified by its name, from a given repository if both the repository and secret exist. | | `delete-deploy-key` | Deletes a specific deploy key from a repository; to change a key's properties or access scope, the existing key must be deleted and a new one created. | | `delete-deployment` | Permanently deletes a specified *inactive* deployment from a repository. | | `delete-deployment-branch-policy` | Deletes a specific deployment branch or tag policy, identified by its ID, from a given environment within a repository. | | `delete-discussion` | Deletes a specific team discussion, identified by its number, from an organization's team. | | `delete-discussion-comment` | Deletes a specific comment from an existing team discussion within an organization, provided the specified organization, team, discussion, and comment all exist. | | `delete-email-address` | Sends an empty request body to `DELETE /user/emails` to attempt deletion of user email addresses; the API typically requires specific emails, so outcome may vary. | | `delete-environment` | Deletes an existing deployment environment from an existing repository. | | `delete-environment-secret` | Deletes an existing and accessible secret from a specified environment within a GitHub repository, returning an empty dictionary on success or error details otherwise. | | `delete-environment-variable` | Deletes a named environment variable from a specified, existing environment within a GitHub repository. | | `delete-gist` | Permanently deletes an existing GitHub gist, specified by its `gist_id`; this action is destructive and cannot be undone. | | `delete-gist-comment` | Deletes a specific comment from a GitHub Gist using its `gist_id` and `comment_id`. | | `delete-actions-cache-by-id` | Deletes a specific GitHub Actions cache from a repository using its unique `cache_id`. | | `delete-pages-site` | Deletes the GitHub Pages site for the specified repository; completes without error if no site is currently enabled. | | `delete-issue-comment` | Permanently deletes a specific comment by its ID from an issue or pull request, if the repository exists and the comment ID is valid. | | `delete-issue-comment-reaction` | Deletes a reaction from an issue comment in a repository; the repository, comment, and reaction must exist. | | `delete-issue-reaction` | Permanently removes a specific reaction from an issue in a GitHub repository. | | `delete-label` | Permanently removes an existing label from a repository. | | `delete-milestone` | Deletes the specified milestone if it exists; this operation is idempotent, typically returning a 404 if the milestone is not found or already deleted. | | `delete-organization` | Deletes a GitHub organization and its repositories; this is a destructive action and the organization name will be unavailable for reuse for approximately 90 days. | | `delete-organization-secret` | Permanently deletes a secret from a GitHub organization, making it inaccessible to GitHub Actions workflows or other tools. | | `delete-organization-variable` | Deletes a named GitHub Actions variable from a specified organization. | | `delete-organization-webhook` | Deletes a specific webhook, identified by `hook_id`, from an existing organization. | | `delete-org-codespace` | Permanently deletes a specific codespace belonging to a member of the specified organization. | | `delete-org-package` | Deletes a specific package in an organization; cannot delete public packages with over 5,000 downloads. | | `delete-package` | Permanently deletes a specific package owned by the authenticated user; public packages downloaded over 5,000 times cannot be deleted via this API. | | `delete-package-version` | Tool to delete a package version using GitHub GraphQL API. Use when you need to remove a specific version of a package by its global node ID. | | `delete-package-version-for-organization` | Deletes a specific package version within an organization; requires admin permissions for packages with over 5,000 downloads. | | `delete-package-version-for-user` | Permanently and irreversibly deletes a specific version of a package owned by the specified user. | | `delete-pending-review` | Deletes a pending (unsubmitted) review from a pull request; this is only possible if the review has not yet been submitted. | | `delete-project` | Deletes the specified GitHub project (Projects V2) using the GraphQL API. | | `delete-project-card` | Deletes a project card from a GitHub 'Project (classic)'; this operation is idempotent. | | `delete-project-column` | Deletes a project field (column) from a GitHub Projects V2 project using the GraphQL API. | | `delete-project-item-for-user` | Tool to delete a project item for a user in GitHub Projects V2. | | `delete-pull-request-comment-reaction` | Deletes a specific reaction from a pull request review comment, provided the comment and reaction exist on that comment within the specified repository. | | `delete-pull-request-review-protection` | Disables the requirement for pull request reviews before merging for a specific, existing branch in an existing repository; this action is idempotent... | | `delete-repo-codespace-secret-by-name` | Deletes a specific Codespace secret from a repository by its name; this action is idempotent and will succeed even if the secret doesn't exist. | | `delete-social-accounts-for-authenticated-user` | Deletes currently linked social media account URLs from the authenticated user's GitHub profile. | | `delete-team-discussion-comment-reaction` | Deletes a reaction from a team discussion comment, given the organization name, team slug, discussion number, comment number, and reaction ID. | | `delete-team-discussion-reaction` | Permanently deletes a specific reaction from a team discussion within an organization. | | `delete-user-list` | Tool to delete a GitHub user list using GraphQL. Use when you need to remove a user list from a GitHub account. | | `delete-user-package` | Deletes a package owned by the specified user, requiring admin permissions for the authenticated user; deletion of public packages with over 5,000... | | `delete-workflow-run-logs` | Deletes all logs for a specific workflow run in a GitHub repository, provided the repository and run exist. | | `disable-custom-protection-rule-for-environment` | Disables a specific, currently active custom deployment protection rule for an existing environment within a GitHub repository. | | `disable-workflow` | Disables a specified workflow (by ID or filename) in a given GitHub repository, preventing new automatic triggers; any in-progress runs will continue. | | `disable-private-vuln-reporting-for-repo` | Disables private vulnerability reporting for an existing GitHub repository, preventing direct private vulnerability reports to maintainers via... | | `disable-repository-actions-in-org` | Removes a repository from the list of selected repositories enabled for GitHub Actions in an organization. | | `dismiss-review-for-pull-request` | Dismisses an APPROVED or CHANGES\_REQUESTED review on a pull request with a mandatory explanatory message. | | `download-artifact` | Downloads a GitHub Actions workflow artifact as a ZIP file. Returns the artifact as a downloadable file. | | `download-repository-archive-tar` | Downloads a repository's source code as a tarball (.tar.gz) archive for a specific Git reference, if the repository is accessible. | | `download-repository-archive-zip` | Downloads a repository's source code as a ZIP archive for a specific Git reference (branch, tag, or commit SHA). | | `download-job-logs-for-workflow-run` | Downloads logs for a specific job in a GitHub Actions workflow run, contingent on the repository's existence and the job ID being valid and having produced logs. | | `download-workflow-run-attempt-logs` | Downloads a ZIP archive of logs for a specific workflow run attempt. | | `download-workflow-run-logs` | Downloads logs for a specific GitHub Actions workflow run as a ZIP archive containing log files for each job in the workflow. | | `enable-workflow` | Reactivates a currently disabled GitHub Actions workflow within a repository using its workflow ID or filename. | | `enable-actions-in-selected-repositories` | Sets the specific repositories that can use GitHub Actions within an organization by replacing the current list; only applies if the organization's... | | `enable-private-vuln-reporting-for-repo` | Enables private vulnerability reporting for a repository, allowing security researchers to privately submit vulnerability reports to maintainers. | | `enable-repo-for-actions` | Adds a repository to the list of selected repositories enabled for GitHub Actions in an organization. | | `encrypt-and-update-dev-secret` | Creates or updates a repository's development environment secret using an `encrypted_value` and its corresponding `key_id`; the secret must be... | | `encrypt-org-dev-env-secret` | Creates or updates an organization's GitHub Codespaces secret using an encrypted value and its corresponding public key ID. | | `export-codespace-for-authenticated-user` | Triggers an export of a user's specified codespace, automatically stopping it if active, and returns its export status and download URL. | | `export-sbom-for-repo` | Exports the software bill of materials (SBOM) in SPDX JSON format for a repository, if its dependency graph is enabled and it has at least one commit. | | `find-pull-requests` | Primary tool to find and search pull requests. Supports filtering by repository, author, state, labels, and merge status, and returns structured PR... | | `find-repositories` | AI-optimized repository search with smart filtering by language, stars, topics, and ownership. | | `follow-organization-graphql` | Tool to follow a GitHub organization using GraphQL. Use when you need to make the authenticated user follow an organization. | | `follow-user` | Allows the authenticated user to follow the GitHub user specified by `username`; this action is idempotent and the user cannot follow themselves. | | `follow-user-graphql` | Tool to follow a GitHub user using GraphQL. Use when you need to make the authenticated user follow another user. | | `force-cancel-workflow-run` | Forcefully cancels a queued or in-progress GitHub Actions workflow run, bypassing conditions like always() that would otherwise continue execution. | | `fork-gist` | Forks a specified public gist, creating a copy under the authenticated user's account. | | `generate-release-notes` | Generates Markdown release notes content (listing changes, pull requests, and contributors) for a GitHub repository release, customizable via tags... | | `get-blob` | Retrieves the raw, typically Base64-encoded, content of a file (blob) from a GitHub repository using its SHA hash, if the repository and blob SHA exist. | | `get-branch` | Retrieves detailed information for a specified branch within a GitHub repository. | | `get-access-restrictions` | Lists users, teams, and GitHub Apps with push access to a branch; this branch must be protected in repository settings for detailed restrictions... | | `get-commit` | Retrieves a specific commit from a repository by its owner, name, and a valid commit reference (SHA, branch, or tag), supporting pagination for large diffs. | | `get-admin-branch-protection` | Checks if repository administrators are subject to the branch protection rules on a specific branch. | | `get-all-api-versions` | Retrieves all officially supported, date-based (e.g., "2022-11-28") versions of the GitHub REST API from the /versions endpoint. | | `get-all-contributor-commit-activity` | Retrieves commit activity (total commits, weekly additions/deletions/commits) for all contributors to a repository; may require a retry if GitHub... | | `get-all-deployment-protection-rules-for-env` | Lists all enabled custom deployment protection rules for a specific environment in a repository; the environment must exist and be configured for deployments. | | `get-milestone` | Retrieves detailed information for a specific milestone within a GitHub repository by its number. | | `get-app` | Retrieves publicly available information for an existing GitHub App, identified by its unique URL-friendly `app_slug`. | | `get-artifact` | Gets a specific artifact for a repository by `artifact_id`. This action retrieves the details of a specific artifact from a GitHub repository using... | | `get-assignment` | Retrieves detailed information for a specific GitHub Classroom assignment if the authenticated user is an administrator of the classroom. | | `get-autolink-reference-of-repository` | Retrieves a specific autolink reference (which automatically hyperlinks text like 'JIRA-123' to an external system) for a repository using its unique... | | `get-environment` | Retrieves the details of a specific deployment environment for a given repository, including its name, configurations, and current status. | | `get-environment-public-key` | Retrieves the public key for a specified GitHub repository environment, used to encrypt secrets for GitHub Actions. | | `get-environment-secret` | Retrieves metadata (name and timestamps) for a single secret in a GitHub Actions environment. | | `get-environment-variable` | Retrieves a specific environment variable from a GitHub Actions environment by repository owner, repository name, environment name, and variable name. | | `get-issue` | Retrieves detailed information about a specific issue in a repository using the owner, repository name, and issue number. | | `get-issue-comment` | Action to get an issue comment. | | `get-issue-event` | Fetches details of a specific issue event for a given repository and event ID. | | `get-organization` | Get an organization | | `get-organization-public-key` | Retrieves an organization's public key, which must be used to encrypt secret values before they are configured for Codespaces. | | `get-organization-role` | Retrieves a specific GitHub organization role by its ID. | | `get-organization-secret` | Gets an organization secret's metadata (e.g., name, creation/update dates, visibility), but not its encrypted value. | | `get-organization-variable` | Retrieves details (name, value, visibility, timestamps) of a specific, existing variable for an existing GitHub organization. | | `get-organization-webhook` | Retrieves the full configuration, including subscribed events and delivery settings, for an existing organization webhook. | | `get-package-for-organization` | Retrieves a specific package (by type and name) from an organization, if both the package and organization exist. | | `get-package-for-user` | Retrieves metadata for a specific package owned by a GitHub user, using package type, name, and username as identifiers. | | `get-package-for-authenticated-user` | Retrieves detailed information for a specific package owned by the authenticated user. | | `get-package-version-for-organization` | Retrieves detailed information for a specific version of a package within an organization. | | `get-package-version-for-user` | Retrieves a specific public package version associated with a GitHub user. | | `get-package-version-for-authenticated-user` | Retrieves detailed information for an existing specific package version associated with the authenticated user, identified by its type, name, and version ID. | | `get-project` | Retrieves detailed information for a specific GitHub project (V2) using its project number and owner. | | `get-project-card` | Retrieves all details of a specific project card, given its unique `card_id`. | | `get-project-column` | Retrieves detailed information for a specific project column from GitHub Projects (classic). | | `get-pull-request` | Retrieves a specific pull request from a GitHub repository using its owner, repository name, and pull request number. | | `get-reference` | Retrieves a specific Git reference (e.g., a branch, tag, or fully qualified like 'heads/main') from a GitHub repository. | | `get-release` | Gets a specific release from a GitHub repository, provided the repository is accessible and the release exists. | | `get-release-asset` | Gets metadata for a specific release asset in a GitHub repository, including a `browser_download_url` for downloading the asset. | | `get-release-by-tag-name` | Gets a release from a GitHub repository by its tag name; the repository and a release with this tag must already exist. | | `get-repository` | Retrieves detailed information about an existing and accessible GitHub repository. | | `get-repository-public-key` | Gets a repository's public key for encrypting secrets to be used in GitHub Actions, if the repository exists and is accessible. | | `get-repository-readme` | Fetches the README file (if it exists and is accessible) from a specified GitHub repository, returning its Base64-encoded content and metadata. | | `get-repository-readme-for-directory` | Retrieves the README file from a specified directory within a GitHub repository, optionally at a given commit, branch, or tag. | | `get-repository-ruleset` | Retrieves a specific repository ruleset by its ID; if `includes_parents` is true, the search for this `ruleset_id` also extends to rulesets from parent organizations. | | `get-repository-rule-suite` | Gets detailed information for a specific repository rule suite by its ID, including its evaluation status and the results of its individual rules. | | `get-repository-secret` | Gets metadata (name, creation/update timestamps) for an existing repository secret, excluding its encrypted value. | | `get-repository-subscription` | Gets the authenticated user's subscription details for a repository, indicating if they receive notifications. | | `get-repository-variable` | Gets a specific GitHub Actions variable by name from an accessible repository. | | `get-repository-webhook` | Returns the configuration of an existing webhook for a given repository. | | `get-review-comment-for-pull-request` | Retrieves a specific pull request review comment by its ID, provided the repository exists, is accessible, and the comment ID is valid. | | `get-review-for-pull-request` | Retrieves a specific review for a pull request using its owner, repository, pull request number, and review ID. | | `get-secret-for-authenticated-user` | Retrieves metadata (name, timestamps, visibility; not the value) for a specific, existing development environment secret associated with the... | | `get-self-hosted-runner-for-organization` | Retrieves detailed information about a specific self-hosted runner registered within a GitHub organization. | | `get-self-hosted-runner-for-repository` | Gets a specific self-hosted runner for a repository by its unique ID. | | `get-assignment-grades` | Retrieves all grades for an existing GitHub Classroom assignment. | | `get-tag` | Retrieves detailed information for a specific Git tag object from a GitHub repository, using the SHA of the tag object itself. | | `get-team-by-name` | Retrieves a GitHub team by its slug from a specific organization. | | `get-thread` | Retrieves a specific GitHub notification thread using its unique `thread_id`. | | `get-thread-subscription-for-authenticated-user` | Retrieves the authenticated user's subscription details for a specific notification thread, identified by `thread_id`. | | `get-tree` | Browse and list all files/directories in a GitHub repository. | | `get-user` | Retrieves the public profile information for an existing GitHub user, specified by their username. | | `get-webhook-configuration-for-organization` | Retrieves the configuration for a specific webhook associated with a GitHub organization. | | `get-webhook-configuration-for-repository` | Returns the configuration for an existing webhook on the specified repository. | | `get-webhook-delivery-for-organization-webhook` | Returns detailed information for a specific delivery attempt of a webhook configured for the specified GitHub organization. | | `get-workflow` | Retrieves detailed information for a specific GitHub Actions workflow in a repository, identified by either its numeric ID or its filename. | | `get-workflow-run` | Gets a specific workflow run by its ID from a GitHub repository. | | `get-workflow-run-attempt` | Retrieves detailed information for a specific attempt of a workflow run in a GitHub repository, including its status, conclusion, and timings. | | `get-billing-usage-report-user` | Retrieves the billing usage report for a specified GitHub user. | | `get-branch-protection` | Retrieves branch protection settings for a specific, existing, and accessible branch in a GitHub repository; protection feature availability varies... | | `get-catalog-models` | Tool to retrieve the list of AI models available in the GitHub Models catalog. | | `get-check-run` | Retrieves detailed information for a specific check run within a GitHub repository. | | `get-check-suite` | Retrieves a specific check suite (a collection of check runs) by its ID from a repository accessible to the authenticated user. | | `get-classroom` | Retrieves details for a specific GitHub Classroom. Requires the authenticated user to be an administrator of the classroom. | | `get-code-of-conduct` | Retrieves the full details of a specific GitHub code of conduct using its unique key. | | `get-code-of-conduct-graph-ql` | Tool to look up a code of conduct by its key using GitHub's GraphQL API. | | `get-codeql-database` | Gets an existing CodeQL database (including a download URL) for a specified language in an accessible repository, if one has been successfully built for that language. | | `get-code-scanning-alert` | Retrieves a specific code scanning alert, which identifies potential code vulnerabilities or errors, by its number from the specified GitHub repository. | | `get-code-scanning-analysis` | Retrieves detailed information for a specific code scanning analysis on an accessible repository, identified by its `analysis_id`. | | `get-code-scanning-default-setup` | Gets the default setup configuration for code scanning in a repository, including state, languages, query suite, and schedule for a repository if it exists. | | `get-codespace` | Call to retrieve detailed information for a `codespace_name` belonging to the authenticated user, ensuring the codespace exists and is accessible. | | `get-commit-authors` | Fetches commit authors identified during a repository import, used to map authors from an external VCS to GitHub accounts. | | `get-commit-comment` | Retrieves the full details of a specific commit comment in a GitHub repository, using its unique identifier. | | `get-commit-object` | Retrieves detailed information (including author, committer, message, tree, parents, verification) for a specific commit in a GitHub repository, identified by its SHA. | | `get-commit-signature-protection` | Gets the commit signature protection status for a branch in a repository. | | `get-commit-statuses` | List all statuses for a commit reference (SHA, branch, or tag) in reverse chronological order. | | `get-community-profile-metrics` | Retrieves a repository's community profile metrics, including health percentage and the presence of key community files (e.g., README, LICENSE). | | `get-contextual-information-for-user` | Gets contextual hovercard information for a GitHub user; `subject_type` and `subject_id` can be jointly provided for more specific details. | | `get-custom-deployment-protection-rule` | Retrieves a specific custom deployment protection rule (used by GitHub Apps for external validation or manual approval of deployments) for a given... | | `get-default-attributes-for-codespace` | Get pre-flight data (e.g., default location, devcontainer path) for creating a Codespace in a given repository (must exist and be accessible)... | | `get-default-workflow-permissions-for-organization` | Gets the default GITHUB\_TOKEN workflow permissions and settings for a GitHub organization. | | `get-default-workflow-permissions-for-repository` | Gets the default workflow permissions (`read` or `write`) for the GITHUB\_TOKEN and whether it can approve pull request reviews in an existing and accessible repository. | | `get-dependency-diff` | Gets the dependency diff between two Git revisions in a repository, where 'basehead' specifies the revisions and 'name' can optionally scope to a specific manifest file. | | `get-deploy-key` | Gets a specific deploy key, identified by its `key_id`, for the GitHub repository specified by `owner` and `repo`. | | `get-deployment` | Gets a specific deployment by ID from a repository, provided the repository and deployment ID exist. | | `get-deployment-branch-policy` | Retrieves a specific deployment branch policy for an environment in a repository, identified by its unique ID. | | `get-deployment-status` | Retrieves a specific deployment status by its ID for a given deployment within a GitHub repository. | | `get-details-about-codespace-export` | Retrieves detailed information about a specific export of a codespace. | | `get-discussion` | Fetches a specific discussion by its number from a team within an organization. | | `get-discussion-comment` | Fetches a specific comment from a team discussion within a specific organization. | | `get-emojis` | Lists all emojis available for use on GitHub, including custom and Unicode emojis. | | `get-enterprise-member-invitation` | Tool to look up a pending enterprise unaffiliated member invitation by invitee and enterprise. | | `get-feeds` | Fetches a list of available GitHub feed URLs for the authenticated user. | | `get-gist` | Fetches a specific GitHub gist by its `gist_id`, returning comprehensive details if the gist exists. | | `get-gist-comment` | Retrieves a specific Gist comment by its ID and the Gist's ID. | | `get-gist-revision` | Retrieves a specific revision of a gist. | | `get-actions-cache-usage-for-organization` | Retrieves total GitHub Actions cache usage statistics for an organization, including active cache count and size across all repositories. | | `get-actions-cache-usage-for-repository` | Retrieves the total count of active GitHub Actions caches and their combined size in bytes for a specified repository. | | `get-actions-permissions-for-organization` | Gets the GitHub Actions permissions for a specified organization, detailing repository enablement and allowed actions policies. | | `get-actions-permissions-for-repository` | Gets the GitHub Actions permissions policy for a repository, including its enabled status and the scope of allowed actions. | | `get-billing-premium-request-usage-report-user` | Tool to get billing premium request usage report for a GitHub user. | | `get-billing-usage-summary-for-user` | Tool to retrieve billing usage summary for a GitHub user account. | | `get-meta-information` | Fetches GitHub's publicly available metadata, useful for configuring network security policies or IP allow-listing. | | `get-pages-build` | Retrieves detailed information about a specific GitHub Pages build for a repository, which must have GitHub Pages enabled. | | `get-gitignore-template` | Retrieves a specific .gitignore template from GitHub by its name, which must be an existing template in GitHub's collection. | | `get-global-security-advisory` | Retrieve a global GitHub security advisory by its GHSA identifier. | | `get-graphql-node` | Tool to fetch any GitHub object by its global node ID. Use when you have a node\_id and need to retrieve the corresponding object details. | | `get-graphql-rate-limit` | Tool to retrieve the authenticated client's GitHub GraphQL API rate limit information. | | `get-information-about-sarif-upload` | Retrieves detailed information, including processing status and results URL, about a specific SARIF (Static Analysis Results Interchange Format)... | | `get-interaction-restrictions-for-organization` | Retrieves interaction restrictions for an organization, showing which GitHub user types can interact with its public repositories and when... | | `get-interaction-restrictions-for-repository` | Retrieves active interaction restrictions for a repository, detailing which user groups are limited from activities like commenting or creating pull... | | `get-interaction-restrictions-for-public-repos` | Retrieves currently active interaction restrictions for the authenticated user's public repositories. | | `get-issue-comments` | Retrieves all comments for a specific GitHub issue in chronological order. | | `get-label` | Retrieves a specific label by its name from a specified GitHub repository. | | `get-large-files` | Lists files larger than 100MB identified during a previous source import for the specified repository. | | `get-latest-pages-build` | Retrieves information about the most recent GitHub Pages build for a repository, which must exist, be accessible, have GitHub Pages enabled, and have... | | `get-license` | Call this action to retrieve comprehensive details for a specific software license recognized by GitHub, using its unique license key. | | `get-license-graph-ql` | Tool to look up an open source license by its SPDX ID using GitHub's GraphQL API. | | `get-octocat` | Fetches an ASCII art representation of GitHub's Octocat, suitable for text-based displays. | | `get-oidc-subject-claim-template` | Retrieves the OpenID Connect (OIDC) subject claim customization template for a repository, which defines the `sub` claim structure in OIDC tokens for... | | `get-org-allowed-actions` | Gets the list of allowed actions and reusable workflows for an organization when the 'allowed\_actions' policy is set to 'selected'. | | `get-organization-audit-log` | Tool to retrieve an organization's audit log events for security and compliance investigations. | | `get-organization-custom-property` | Retrieves the definition (schema) of a specific, existing custom property for an organization. | | `get-organization-project-item` | Tool to get an item from an organization-owned GitHub Projects V2 project. | | `get-organization-public-key-for-dependabot` | Retrieves the public key for an existing GitHub organization, required for encrypting Dependabot secrets. | | `get-organization-teams` | Retrieves a list of teams for a specified GitHub organization. | | `get-org-dev-environment-secret-safely` | Retrieves metadata for a specific secret available to an organization's GitHub Codespaces without exposing its encrypted value. | | `get-org-oidc-subject-claim-template` | Retrieves the OpenID Connect (OIDC) subject claim customization template for a GitHub organization, which defines how the `sub` claim in OIDC tokens... | | `get-pages-dns-health-check` | Retrieves the DNS health check status (e.g., CNAME/A records, HTTPS) for a GitHub Pages site; the check may be pending (HTTP 202) on initial calls or after site changes. | | `get-pages-site` | Retrieves information for a GitHub Pages site, which must be enabled for the repository. | | `get-page-views` | Retrieves page view statistics for a repository over the last 14 days, including total views, unique visitors, and a daily or weekly breakdown. | | `get-pending-deployments-for-workflow-run` | Retrieves pending deployment environments for a specific workflow run that are awaiting approval due to protection rules. | | `get-project-permission-for-user` | Retrieves permission information for a GitHub project (classic) collaborator. | | `get-public-key-for-secret-encryption` | Retrieves a repository's public key for encrypting GitHub Codespaces secrets; requires `repo` scope or equivalent read access to codespaces secrets... | | `get-public-key-for-authenticated-user` | Retrieves the authenticated user's public key for encrypting GitHub Codespaces secrets. | | `get-pull-request-review-protection` | Retrieves the pull request review protection settings for a specific branch in a GitHub repository, if such protection is configured. | | `get-pull-requests` | Retrieves a list of pull requests from a repository with flexible filtering options. | | `get-rate-limit-status-for-authenticated-user` | Retrieves the authenticated user's current GitHub API rate limit status, including usage and limits across different resource categories. | | `get-raw-repository-content` | Tool to fetch raw file content from a GitHub repository. Returns raw bytes in whatever format the file uses (JSON, CSV, binary, etc.) - parsing and... | | `get-repo-allowed-actions` | Gets the settings for allowed actions and reusable workflows in a repository. | | `get-repo-dev-env-secret` | Gets metadata (name, creation/update timestamps) for a specific, existing development environment secret (Codespaces secret) in a repository, without exposing its value. | | `get-repos-attestations` | Tool to retrieve attestations by subject digest from a GitHub repository. | | `get-repository-clones` | Retrieves the total number of clones and a breakdown of clone activity (daily or weekly) for a specified repository over the preceding 14 days. | | `get-repository-content` | Retrieves a file's Base64 encoded content or lists a directory's contents from a GitHub repository. | | `get-repository-graph-ql` | Tool to lookup a repository by owner and name using GitHub's GraphQL API. | | `get-repository-owner` | Tool to lookup a repository owner (User or Organization) by login using GitHub's GraphQL API. | | `get-repository-permissions-for-user` | Retrieves a specific user's permission level ('admin', 'write', 'read', or 'none') for a given repository, where 'maintain' role is reported as... | | `get-repository-public-key-for-encryption` | Gets a repository's public key, used to encrypt secrets for Dependabot. | | `get-repository-secret-securely` | Retrieves metadata for an existing Dependabot secret in a repository, without exposing its encrypted value. | | `get-repository-security-advisory` | Tool to retrieve a repository security advisory using its GHSA identifier. | | `get-repository-webhook-delivery` | Retrieves a specific delivery for a repository webhook, identified by its `hook_id` and `delivery_id`. | | `get-rules-for-branch` | Retrieves all active rules for a specific branch in a GitHub repository, excluding rules in 'evaluate' or 'disabled' status. | | `get-single-org-secret-without-decryption` | Gets a single organization Dependabot secret's metadata (name, timestamps, visibility) without revealing its encrypted value. | | `get-status-checks-protection` | Retrieves the status check protection settings for a specific branch in a GitHub repository, if status check protection is enabled for it. | | `get-team-members` | Retrieves a list of members for a specific team within an organization. | | `get-team-membership-for-user` | Retrieves a user's role and membership status within a specific team in an organization. | | `get-teams-with-access-to-protected-branch` | Lists teams with explicit push access to a protected branch, provided team restrictions are configured in the branch's protection settings; returns... | | `get-authenticated-user` | Gets the profile information for the currently authenticated GitHub user, including potentially private details based on user settings. | | `get-combined-status-for-specific-reference` | Retrieves the aggregated commit status (e.g., success, failure, pending) from all checks for a specific reference (SHA, branch, or tag) in a GitHub repository. | | `get-hourly-commit-count-for-each-day` | Retrieves the 'punch card' data, showing hourly commit counts for each day of the week for an existing and accessible repository. | | `get-last-year-of-commit-activity` | Fetches weekly commit totals and daily commit counts for the last 52 weeks for a specified GitHub repository. | | `get-latest-release` | Fetches the latest official (non-prerelease, non-draft) release for a GitHub repository; requires at least one such published release. | | `get-license-for-repository` | Retrieves the license file and its details for a repository, optionally from a specific Git reference (branch, tag, or commit SHA). | | `get-review-history-for-workflow-run` | Retrieves the detailed approval history for a specific workflow run in a GitHub repository, detailing each review's environment, state, reviewer, and... | | `get-status-of-pages-deployment` | Retrieves the status of a specific GitHub Pages deployment for a repository, which must have GitHub Pages enabled. | | `get-weekly-commit-activity` | Fetches the weekly commit activity (additions and deletions per week) for a repository over the past year; best for repositories with under 10,000 commits. | | `get-weekly-commit-count` | Retrieves the weekly commit count for a repository, detailing commits by the owner and all contributors over the last 52 weeks; GitHub may return a... | | `get-zen-of-github` | Retrieves a random quote from GitHub's 'Zen of GitHub' collection, reflecting GitHub's design philosophies and offering humorous insights, useful for... | | `get-top-referral-paths` | Fetches the top 10 most viewed content paths for a repository from the last 14 days. | | `get-top-referral-sources` | Fetches the top 10 websites that referred traffic to a repository within the last 14 days. | | `get-user-by-id` | Retrieves a GitHub user's profile information by their unique numeric account ID. | | `get-user-project-item` | Tool to get an item from a user-owned project in GitHub Projects V2. | | `get-users-attestations` | Tool to get attestations by subject digest for a GitHub user. | | `get-users-projects-v2` | Tool to list GitHub Projects v2 for a specified user. Use when you need to retrieve all projects owned by a user with pagination support. | | `get-users-with-access-to-protected-branch` | Lists users with explicit push access to a protected branch, provided its protection rule restricts pushes to specific users. | | `get-viewer-graphql` | Tool to retrieve the authenticated user's profile information via GitHub GraphQL. | | `get-workflow-external-access` | Gets the access level settings for a private repository, determining how workflows outside this repository can use its actions and reusable workflows. | | `get-workflow-run-job` | Retrieves detailed information for a specific job within a GitHub Actions workflow run, given its `job_id` which must be valid for the specified repository's workflow. | | `get-workflow-run-usage` | Gets the billable time, in milliseconds, for a specific workflow run, detailing time spent on various operating systems. | | `get-workflow-usage` | Gets the billable time (in milliseconds, broken down by runner OS) for a specific workflow within a repository for the current billing cycle. | | `is-repository-starred-by-user` | Use to determine if the authenticated user has starred a specific GitHub repository, which is confirmed by an HTTP 204 status (resulting in an empty... | | `list-accepted-assignments-for-assignment` | Lists accepted assignments (student repositories created after acceptance) for an existing GitHub Classroom assignment, identified by its unique `assignment_id`. | | `list-accessible-repositories` | Lists repositories that the authenticated user can access through a specific GitHub App installation. | | `list-app-installations` | Lists GitHub App installations accessible to the authenticated user via their access token, including installation details, permissions, and repository access. | | `list-apps-with-access-to-protected-branch` | Lists GitHub Apps with push access to a repository's protected branch. | | `list-artifacts-for-repository` | Lists GitHub Actions workflow artifacts for a specified repository, which must exist. | | `list-assignees` | Lists users who can be assigned to issues in a repository, typically those with push access. | | `list-assignments-for-classroom` | Lists all assignments for a given GitHub Classroom `classroom_id`; the classroom must exist and be accessible. | | `list-attestation-repositories` | Tool to list attestation repositories for an organization. Use when you need to discover which repositories in an organization have attestations. | | `list-available-machine-types-for-repository` | Lists machine types available for GitHub Codespaces in a repository, optionally using a Git ref to check compatibility based on prebuild availability... | | `list-branches` | List branches in a GitHub repository. Returns branch names, commit information, and protection status. | | `list-branches-for-head-commit` | Lists branches in an accessible repository where the provided commit SHA is the head, useful for identifying development lines based on that commit. | | `list-check-run-annotations` | Lists annotations for a specific check run in a GitHub repository, detailing issues like errors or warnings on particular code lines. | | `list-check-runs-for-ref` | List GitHub check runs for a commit SHA, branch, or tag to assess CI status and conclusions. | | `list-check-runs-in-check-suite` | Lists check runs for a specific check suite in a GitHub repository, optionally filtering by check name or status. | | `list-check-suites-for-git-reference` | Lists check suites for a Git reference (commit SHA, branch, or tag) in a repository, optionally filtering by GitHub App ID or check run name. | | `list-child-teams` | Lists the immediate child teams of a parent team within an organization. | | `list-classrooms` | Lists GitHub Classrooms to which the authenticated user has administrative access. | | `list-codeowners-errors` | Lists syntax errors in a repository's CODEOWNERS file, which must be located at the root, `.github/`, or `docs/` directory for the specified ref. | | `list-codeql-databases-for-repository` | Lists all CodeQL databases for a repository where CodeQL analysis has been previously run and completed. | | `list-code-scanning-alerts-for-organization` | Lists code scanning alerts for a GitHub organization; use EITHER `tool_name` OR `tool_guid` if filtering by tool, not both. | | `list-code-scanning-alerts-for-repository` | Lists code scanning alerts for a repository, optionally filtering by tool (which must have produced scan results for the repository), Git reference, state, or severity. | | `list-code-scanning-analyses-for-repository` | Lists code scanning analyses for an existing repository, optionally filtering by tool (name or GUID), Git reference, or SARIF ID. | | `list-codes-of-conduct` | Retrieves all available codes of conduct from GitHub, often used to select one for a repository. | | `list-codes-of-conduct-graphql` | Tool to fetch all available codes of conduct using GitHub's GraphQL API. | | `list-codespaces-for-user-in-organization` | Lists all GitHub Codespaces owned by a specified member of a given organization. | | `list-codespaces-for-authenticated-user` | Lists GitHub Codespaces for the authenticated user, optionally filtering by repository ID and supporting pagination. | | `list-codespaces-for-organization` | Lists active/pending GitHub Codespaces for an existing organization; admins list all, members list their own. | | `list-comment-changes` | Tool to list issue and PR comment changes across an organization's repositories efficiently. | | `list-comments-for-pull-request-review` | Lists all comments for a specific review on a GitHub pull request. | | `list-commit-comments` | Retrieves all comments for a specific commit in a GitHub repository, supporting pagination. | | `list-commit-comments-for-repository` | Lists all commit comments for a specified repository, which must exist and be accessible. | | `list-commits` | Lists commits for a GitHub repository. Requires 'owner' (username/org) and 'repo' (repository name) parameters. | | `list-commits-on-pull-request` | Lists commits for a pull request; requires the repository and pull request to exist and be accessible, and supports pagination. | | `list-commonly-used-licenses` | Retrieves a list of commonly used software licenses from GitHub, optionally filtering for 'featured' licenses whose specific selection criteria by GitHub may vary. | | `list-custom-properties-for-organization` | Gets the schema definitions for all custom properties configured for an organization, not the specific values assigned to repositories. | | `list-custom-property-values-for-repository` | Gets all custom property values for a repository. Custom properties are defined at the organization level, so this endpoint works with organization-owned repositories. | | `list-custom-property-values-for-org-repos` | Lists repositories in an organization with their custom property values. | | `list-deliveries-for-organization-webhook` | Retrieves a list of webhook deliveries for a specific webhook in an organization, allowing inspection of delivery history and details. | | `list-deliveries-for-repository-webhook` | Retrieves delivery attempts for a specific repository webhook to inspect its history; ensure the webhook ID exists. | | `list-deploy-keys` | Lists deploy SSH keys for a specified repository; the repository must exist. | | `list-deployment-branch-policies` | Lists all deployment branch policies for a specified environment in a GitHub repository. | | `list-deployments` | Lists deployments for a specified repository; repository must exist. | | `list-deployment-statuses` | Lists all statuses for a given deployment in a repository. | | `list-discussion-comments` | Lists all comments for a specific team discussion within an organization. | | `list-discussions` | Lists discussions for a specific team within an organization, with options for sorting, pagination, and filtering by pinned status. | | `list-email-addresses-for-authenticated-user` | Lists all email addresses for the authenticated user, including their primary status, verification status, and visibility. | | `list-environment-custom-deployment-rules` | Lists all custom deployment protection rule integrations for a repository environment; the `environment_name` must be URL-encoded. | | `list-environments` | Retrieves all deployment environments for a specified repository, which are used to configure protection rules and secrets for different software lifecycle stages. | | `list-environment-secrets` | Lists the names and metadata (not values) of secrets for a specified, existing environment within an existing GitHub repository. | | `list-environment-variables` | Lists all environment variables, which are plaintext key-value pairs for GitHub Actions workflows, for a specified environment within a GitHub repository. | | `list-events-for-authenticated-user` | Lists public events for the specified GitHub user, or private events if authenticated as that user, in reverse chronological order. | | `list-events-for-user` | Lists events performed by a GitHub user in reverse chronological order. | | `list-events-received-by-authenticated-user` | Lists events a specific GitHub user received from followed users and watched repositories; returns private events if authenticated for `username`, otherwise public. | | `list-followers-of-user` | Lists followers for a specified, existing GitHub user. | | `list-followers-of-authenticated-user` | Lists users following the authenticated GitHub user, returning an empty list if the user has no followers. | | `list-following-for-user` | Lists the people that a GitHub user follows. Use this action when you need to retrieve the list of users that a specific GitHub user is following. | | `list-forks` | Lists forks for a specified repository, which must exist, with options for sorting and pagination. | | `list-gist-comments` | Lists comments for a specified GitHub Gist. | | `list-gist-commits` | Lists all commits for a specified gist. | | `list-gist-forks` | Lists all forks for a given GitHub gist ID. | | `list-gists-for-user` | *lists public gists for a specified GitHub user.* | | `list-gists-for-authenticated-user` | Lists gists for the authenticated user, with optional filtering by update time and pagination. | | `list-actions-caches-for-repository` | Lists GitHub Actions caches for a repository, with options to filter by Git reference or cache key, and to sort and paginate results. | | `list-pages-builds` | Lists GitHub Pages builds for a repository; GitHub Pages must be enabled on the repository for builds to be listed. | | `list-gitignore-templates` | Retrieves all available .gitignore template names from GitHub (e.g., 'Python', 'Node', 'Java'), used for generating .gitignore files. | | `list-global-security-advisories` | Lists GitHub's global security advisories, filterable by various attributes including ID, type, ecosystem, severity, and dates. | | `list-gpg-keys-for-user` | Tool to list GPG keys for a GitHub user. Use when you need to fetch the public GPG keys associated with a specific GitHub user account. | | `list-installation-requests-for-authenticated-app` | Lists pending installation requests made by users or organizations for the authenticated GitHub App. | | `list-instances-of-code-scanning-alert` | Lists all instances of a specific code scanning alert, optionally filtered by Git ref; requires code scanning to be enabled on the repository. | | `list-issue-comments` | Lists comments for a specified issue in a GitHub repository. | | `list-issue-comments-for-repository` | Lists issue comments, including those on pull requests, for an accessible repository. | | `list-issue-dependencies-blocked-by` | Tool to list dependencies an issue is blocked by. Use when you need to retrieve all issues that are blocking a specific issue from being closed or completed. | | `list-issue-dependencies-blocking` | Tool to list dependencies an issue is blocking. Use when you need to see which issues are blocked by a specific issue. | | `list-issue-events` | Retrieves a list of all events for a specific issue within a GitHub repository. | | `list-issue-events-for-repository` | Lists all issue events (e.g., closed, reopened, assigned) for a specified repository. | | `list-issues-assigned-to-authenticated-user` | Lists GitHub issues for the authenticated user across visible repositories, with filtering by user relationship, state, labels, an ISO 8601 `since`... | | `list-issue-types` | List all issue types configured for a GitHub organization. Requires read:org scope for OAuth tokens. | | `list-jobs-for-workflow-run` | Lists jobs for a specific workflow run in a GitHub repository. | | `list-jobs-for-workflow-run-attempt` | Lists jobs, including details like ID, status, and steps, for a specific attempt of a GitHub Actions workflow run. | | `list-labels-for-issue` | Lists all labels for a specified issue in a GitHub repository. | | `list-labels-for-repository` | Retrieves all labels for a specified, existing GitHub repository. | | `list-labels-for-self-hosted-runner-for-repository` | Lists all labels assigned to a specific self-hosted runner registered with the given repository. | | `list-labels-for-issues-in-milestone` | Lists all labels for issues within a specific milestone in a repository. | | `list-labels-for-self-hosted-runner-org` | Lists all labels assigned to a specific self-hosted runner within a GitHub organization, which are used to route workflows. | | `list-licenses-graph-ql` | Tool to fetch all known open source licenses using GitHub's GraphQL API. | | `list-machine-types-for-codespace` | Lists available machine types for a specific, accessible codespace, enabling it to be transitioned to a new hardware configuration. | | `list-matching-references` | Lists all Git references (branches or tags) in a repository that start with the provided partial reference path (e.g., `heads/my-feature` or `tags/v1.2`). | | `list-milestones` | Lists milestones, which track progress for groups of issues and pull requests, for an existing repository, allowing filtering by state and sorting. | | `list-notifications` | Tool to list notification threads for the authenticated user with efficient polling support. | | `list-notifications-for-authenticated-user` | DEPRECATED: Use GITHUB\_LIST\_NOTIFICATIONS instead. Lists notifications for the authenticated user, sorted by most recent update, with filtering and pagination options. | | `list-organization-codespaces-secrets` | Lists all Codespaces secrets available for a specified organization, which must exist. | | `list-organization-events-for-authenticated-user` | Lists public events in a specified GitHub organization for the authenticated user's organization dashboard. | | `list-organization-members` | Tool to list all members of a GitHub organization. Returns a list of users who are members of the specified organization. | | `list-organization-memberships-for-authenticated-u` | List organization memberships for authenticated user | | `list-organization-projects` | Lists projects (V2) for a specified GitHub organization, with optional search query and cursor-based pagination. | | `list-organization-repositories` | Retrieves a list of repositories for a specified GitHub organization, allowing filtering by type and sorting. | | `list-organization-roles-for-organization` | Lists all custom organization roles for an existing GitHub organization. | | `list-organizations` | Lists GitHub organizations for the authenticated user, sorted by ID in ascending order. | | `list-organization-secrets` | Lists GitHub Actions secrets available for a specified organization. | | `list-organizations-for-user` | List public organization memberships for a GitHub user. This returns all organizations where the specified user is a public member. | | `list-organizations-for-authenticated-user` | Lists organizations the authenticated GitHub user is a member of, returning details for each organization. | | `list-organization-variables` | Lists all GitHub Actions variables for a specified organization. | | `list-organization-webhooks` | Lists all webhooks for a specified GitHub organization; the organization must exist. | | `list-org-fine-grained-permissions` | Lists all fine-grained permissions available in a GitHub organization for use in custom organization roles. | | `list-org-issues-for-authenticated-user` | Lists issues for the authenticated user within a specified GitHub organization, with options to filter by involvement type, state, labels, and to sort results. | | `list-org-package-versions` | Lists all versions for a specified package, if it exists and is owned by the given GitHub organization. | | `list-org-project-view-items` | Tool to list items for an organization project view. Use when you need to retrieve all items from a specific view within a GitHub organization's Projects V2 project. | | `list-org-repos-with-actions-enabled` | Lists the selected repositories that are enabled for GitHub Actions in an organization. | | `list-org-resource-access-tokens` | Lists approved fine-grained personal access tokens (PATs) with access to resources in a GitHub organization, optionally filtering by owner... | | `list-org-resources-with-personal-tokens` | Lists requests from organization members to access organization resources with fine-grained personal access tokens (pending, approved, or denied). | | `list-org-secrets-without-values` | Lists all Dependabot secrets (metadata like names, creation/update timestamps, but not their encrypted values) for a specified organization, which must exist. | | `list-outside-collaborators-for-organization` | Lists outside collaborators for a GitHub organization, with options to filter (e.g., by 2FA status) and paginate results. | | `list-owned-package-versions` | Lists all versions for an existing package owned by the authenticated user, identified by its type and name. | | `list-packages-for-organization` | Lists GitHub Packages for an organization, noting specific interpretations for package\_type and visibility parameters. | | `list-packages-for-user` | Lists packages for a specified GitHub user, filterable by package type and visibility. | | `list-packages-for-authenticated-user` | Lists packages of a specific type and visibility within the authenticated user's namespace on GitHub. | | `list-package-versions-for-package-owned-by-user` | Lists all versions of a public package owned by a specific GitHub user, identified by package type, package name, and username. | | `list-pending-team-invitations` | Lists all pending membership invitations for a specified team within an organization. | | `list-project-cards` | Lists all project cards for a given column\_id in GitHub Projects (classic). | | `list-project-collaborators` | Lists collaborators for a GitHub Project (classic) by project ID. | | `list-project-columns` | Lists all of a GitHub project's columns (e.g., 'To Do', 'In Progress'); project\_id must identify a valid, accessible project. | | `list-project-fields-for-user` | Tool to list all fields in a GitHub Projects V2 project for a specific user. | | `list-project-items-for-user` | Tool to list items for a user-owned GitHub project. Use when you need to retrieve all items (issues, pull requests, draft issues) from a specific... | | `list-project-view-items-for-user` | Tool to list items for a user's GitHub Projects (v2) view. Use when you need to retrieve items from a specific view of a user's project. | | `list-public-emails-for-auth-user` | Lists the public email addresses for the authenticated user. | | `list-public-events` | Lists public GitHub events, which may be delayed by up to 5 minutes, with support for pagination. | | `list-public-events-for-network-of-repositories` | Retrieves public events (up to 90 days old, newest first) for a GitHub repository network, including the repository and its forks. | | `list-public-events-for-user` | Retrieves a list of public events for a specified GitHub user, in reverse chronological order. | | `list-public-events-received-by-user` | Lists public events for a specified GitHub user (e.g., activities in repositories they watch or are involved in); the target user's profile must be... | | `list-public-gists` | Lists public gists from GitHub, optionally filtering by a 'since' timestamp and supporting pagination; results are generally newest first. | | `list-public-keys-for-user` | Lists the verified public SSH keys for a specified GitHub user. | | `list-public-organization-events` | Lists public events for a specified GitHub organization, which must exist. | | `list-public-organization-members` | Lists users who have publicly declared their membership in a specified, existing GitHub organization. | | `list-public-repositories` | Lists all public repositories on GitHub; use the `since` parameter with a repository ID from a previous result for pagination. | | `list-pull-requests` | Lists pull requests for a GitHub repository. REQUIRES 'owner' AND 'repo' parameters - both are MANDATORY and must be provided in every call. | | `list-pull-requests-associated-with-commit` | Lists pull requests for a commit; returns merged PRs that introduced the commit if on the default branch, or open PRs including the commit if on other branches. | | `list-pull-requests-files` | Lists all files (including additions, modifications, and removals) associated with a specific pull request in a GitHub repository. | | `list-reactions-for-commit-comment` | Lists reactions for a specific commit comment; this is a read-only operation. | | `list-reactions-for-issue` | Lists reactions for a specific, existing issue within an accessible GitHub repository, optionally filtering by content type. | | `list-reactions-for-issue-comment` | Lists reactions for a specific issue comment in a GitHub repository, optionally filtering by content type. | | `list-reactions-for-pull-request-review-comment` | Lists reactions for a pull request review comment in a repository, optionally filtering by reaction type. | | `list-reactions-for-release` | Lists all reactions, or optionally filters reactions by a specific content type, for a given GitHub release. | | `list-reactions-for-team-discussion` | Lists reactions for an existing team discussion within an organization. | | `list-reactions-for-team-discussion-comment` | Lists reactions for a specific comment in a team discussion within an organization, optionally filtering by content type. | | `list-release-assets` | Lists assets (e.g., compiled binaries, source code archives) for a specific GitHub release, identified by `release_id` which must be valid for an... | | `list-releases` | Retrieves a list of all releases (published, draft, and prerelease) for a specified repository. | | `list-repo-access-by-token` | Lists repositories in an organization that a fine-grained personal access token has requested access to. | | `list-repo-codespaces` | Lists Codespaces the authenticated user can access within a specified, existing repository. | | `list-repo-dev-container-configs-for-user` | Lists the `devcontainer.json` configurations available in a specified repository for use with GitHub Codespaces. | | `list-repo-invitations-for-auth-user` | Lists all pending repository invitations for the authenticated user. | | `list-repo-notifications-for-auth-user` | Retrieves notifications for the authenticated user from a specified repository, to which the user must have access. | | `list-repo-secrets-without-values` | Lists all Codespaces secrets available in a specific repository, without their encrypted values. | | `list-repositories` | Lists repositories accessible to the authenticated user based on visibility, affiliation, and type filters. | | `list-repositories-accessible-to-app-installation` | Lists repositories a GitHub App installation can access. IMPORTANT: This endpoint requires a GitHub App installation access token (ghs\_\* prefix) for authentication. | | `list-repositories-for-user` | Lists public repositories for a specified GitHub user, who must have an existing account. | | `list-repositories-for-authenticated-user` | Lists repositories for the authenticated user; using 'type' with 'visibility' or 'affiliation' API parameters (not in this model) can cause a 422 error. | | `list-repositories-starred-by-user` | Lists repositories a valid and existing GitHub user has starred. | | `list-repositories-starred-by-authenticated-user` | Lists repositories the authenticated user has starred, optionally sorted and paginated, including star creation timestamps via... | | `list-repositories-watched-by-user` | Lists repositories a given GitHub user is watching; the username must be a valid and existing GitHub user handle. | | `list-repositories-watched-by-authenticated-user` | Lists repositories the authenticated user is watching (subscribed to for notifications). | | `list-repositories-with-actions-cache-usage` | Retrieves a paginated list of GitHub Actions cache usage statistics for repositories within an existing GitHub organization. | | `list-repository-activities` | Lists activities for a GitHub repository, ensuring the repository exists and is accessible. | | `list-repository-autolinks` | Retrieves all autolinks (e.g., for JIRA issues) configured for a repository; requires admin permissions on the repository. | | `list-repository-collaborators` | Lists collaborators for a specified repository, provided it exists and is accessible to the authenticated user. | | `list-repository-contributors` | Lists contributors to a specified repository, sorted by number of contributions in descending order; the repository must exist and be accessible. | | `list-repository-events` | Lists chronological events (e.g., code pushes, issue activities, PR actions, forks) for a specified, existing GitHub repository. | | `list-repository-invitations` | Retrieves all pending (unaccepted or undeclined) collaboration invitations for a specified GitHub repository. | | `list-repository-issues` | Lists issues (including pull requests) from a GitHub repository. | | `list-repository-languages` | Lists the programming languages used in a GitHub repository, returning a byte count for each language. | | `list-repository-organization-secrets` | Lists names of organization-level secrets shared with the specified repository; actual secret values are not returned and visibility depends on token access. | | `list-repository-organization-variables` | Lists organization-level variables that are shared with a specific repository. | | `list-repository-projects` | Lists Projects (classic) associated with a specific repository. | | `list-repository-rulesets` | Retrieves all rulesets for a GitHub repository, which define conditions and actions for repository interactions (e.g., branch protections). | | `list-repository-rule-suites` | Lists rule suite evaluations for a repository, allowing filtering by ref (non-wildcard), time period, actor, and result. | | `list-repository-secrets` | Lists metadata for all secrets in a GitHub repository, excluding their encrypted values. | | `list-repository-secrets-without-decrypting` | Lists metadata (e.g., name, creation/update dates) for all Dependabot secrets in a repository; secret values are not included. | | `list-repository-security-advisories` | Tool to list security advisories for a repository. Use when you need to retrieve security advisories published for a specific repository, optionally filtered by state. | | `list-repository-tags` | Lists tags for a specified GitHub repository. | | `list-repository-teams` | Lists all teams with explicit permission to access the specified repository; the repository must exist. | | `list-repository-topics` | Retrieves all topics for a specified, existing, and accessible repository. | | `list-repository-variables` | Lists plain text key-value variables for GitHub Actions workflows within a specific, accessible repository. | | `list-repository-webhooks` | Retrieves a list of webhooks for a repository, which must exist and be accessible. | | `list-repository-workflows` | Lists all GitHub Actions workflows for a specified repository, which must exist and be accessible. | | `list-requested-reviewers-for-pull-request` | Gets all users and teams requested to review a specific pull request in a repository. | | `list-review-comments-in-repository` | Lists all review comments on all pull requests within a specified repository. | | `list-review-comments-on-pull-request` | Lists all review comments on a specific pull request within a GitHub repository. | | `list-reviews-for-pull-request` | Lists submitted reviews chronologically for a specific pull request within a GitHub repository. | | `list-runner-applications-for-organization` | Lists downloadable GitHub Actions runner application binaries for setting up self-hosted runners in a GitHub organization. | | `list-runner-applications-for-repository` | Lists available self-hosted runner application binaries for a specific repository, including their OS, architecture, and download URL. | | `list-secret-scanning-alerts-for-repository` | List secret scanning alerts for a GitHub repository using first-party detections. | | `list-secrets-for-authenticated-user` | Lists all Codespaces secrets accessible to the authenticated user for use within GitHub Codespaces. | | `list-security-advisories-graphql` | Tool to list GitHub Security Advisories using the GraphQL API. | | `list-security-vulnerabilities` | Query software vulnerabilities documented by GitHub Security Advisories using GraphQL. | | `list-selected-repositories-for-organization-secret` | Lists repositories that have been granted access to a Codespaces organization secret. | | `list-selected-repositories-for-user-secret` | Lists repositories that have access to the specified user Codespaces secret. | | `list-selected-repositories-for-secret-access` | Lists repositories within a specified organization that have been granted access to a particular Dependabot secret. | | `list-selected-repos-org-variable` | Lists repositories in an organization that can access a specific organization variable; supports pagination and returns an empty list if no... | | `list-self-hosted-runners-for-organization` | Lists self-hosted runners for a GitHub organization, optionally filtering by name and paginating results, providing details for each runner such as... | | `list-self-hosted-runners-for-repository` | Lists all self-hosted runners configured for a repository. | | `list-social-accounts-for-user` | Lists social media accounts publicly linked to an existing GitHub user's profile. | | `list-social-accounts-for-authenticated-user` | Lists all social media accounts linked to the authenticated user's GitHub profile. | | `list-sponsorables` | Tool to list users and organizations who can be sponsored via GitHub Sponsors. | | `list-ssh-signing-keys-for-user` | Lists the public SSH signing keys for a specified GitHub user. | | `list-stargazers` | Lists users who have starred the specified GitHub repository, which must exist. | | `list-starred-gists` | Retrieves a list of gists starred by the authenticated user. | | `list-starred-repositories-for-user` | Lists public repositories that a user has starred. The list includes all public repositories starred by the specified user, sorted by when they were... | | `list-status-check-contexts` | Fetches all required status check contexts for a protected branch; returns an empty list if the branch isn't protected or has no required checks. | | `list-sub-issues` | Tool to list sub-issues for a specific GitHub issue. Use when you need to retrieve all sub-issues associated with a parent issue, supporting... | | `list-subscriptions-for-authenticated-user` | Tool to list GitHub Marketplace subscriptions for the authenticated user. | | `list-subscriptions-for-authenticated-user-stubbed` | Lists the authenticated user's stubbed (test/example data, not live) GitHub Marketplace subscriptions, useful for development or testing. | | `list-tag-protection-states-for-repository` | DEPRECATED: Lists tag protection rules for a repository. This API was sunset on August 30, 2024. | | `list-team-members` | Lists members of a specific team within an organization, including members of child teams. | | `list-team-projects` | Lists GitHub projects accessible to a specific team within an organization. | | `list-team-repositories` | Lists repositories accessible to a specific team within a GitHub organization. | | `list-teams` | Lists teams for a specified GitHub organization. | | `list-teams-for-authenticated-user` | Lists all teams across all organizations to which the authenticated user belongs, supporting pagination. | | `list-teams-that-are-assigned-to-organization-role` | Lists teams assigned to a specific role within a GitHub organization. | | `list-people-user-follows` | Lists GitHub users that a valid GitHub `username` is following, supporting pagination. | | `list-people-authenticated-user-follows` | Lists people the authenticated user follows. | | `list-timeline-events-for-issue` | Lists chronological events (e.g., comments, commits, label changes) for a specific issue in a GitHub repository. | | `list-token-access-repositories` | Lists repositories in an organization that a fine-grained personal access token has access to. | | `list-user-projects` | Retrieves a list of projects for a specified GitHub user, optionally filtering by state and supporting pagination; the username must be a valid GitHub handle. | | `list-users` | Retrieves all GitHub users (individuals and organizations) in chronological order of their sign-up date. | | `list-users-blocked-by-organization` | Lists users blocked by a specified GitHub organization. | | `list-users-blocked-by-authenticated-user` | Lists users blocked by the authenticated user, returning an empty list if no users are blocked. | | `list-users-that-are-assigned-to-organization-role` | Lists users assigned to a specific role within a GitHub organization. | | `list-watchers` | Retrieves a list of users watching a specific repository; the repository must be accessible to the authenticated user. | | `list-workflow-run-artifacts` | Lists artifacts (e.g., build outputs, test results) for a specific workflow run in a GitHub repository. | | `list-workflow-runs-for-repository` | Lists workflow runs for a repository, allowing filtering by actor, branch, event, status, creation date, check suite ID, or head SHA; the repository... | | `list-workflow-runs-for-workflow` | Lists runs for a specified, existing workflow (identified by ID or filename like `main.yml`) in a GitHub repository, with filtering options. | | `lock-issue` | Locks an existing GitHub issue's conversation, preventing further comments; an optional reason can be specified. | | `lookup-enterprise-administrator-invitation` | Tool to look up a pending enterprise administrator invitation by invitee, enterprise, and role. | | `lookup-resource` | Tool to lookup a GitHub resource by its URL. Use when you need to identify or retrieve information about a GitHub resource from its URL. | | `lookup-nodes-by-ids` | Tool to lookup GitHub nodes by their global node IDs. Use when you need to retrieve multiple objects by their IDs in a single batch query. | | `lookup-organization-graph-ql` | Tool to lookup a GitHub organization by login using GraphQL. | | `lookup-topic-by-name` | Tool to look up a GitHub topic by name using GraphQL. Use when you need to find information about a specific GitHub topic including its popularity... | | `manage-access-control-for-organization-codespaces` | Sets the Codespaces access control policy for a GitHub organization, determining which members can use them. | | `manage-custom-properties-for-org-repos` | Creates or updates values for an organization's predefined custom properties across multiple repositories (up to 30). | | `manage-secrets-in-selected-repositories` | Lists repositories within an organization that have been explicitly granted access to a specific GitHub Actions organization secret. | | `map-commit-author` | Updates Git author information (name and/or email) for an `author_id` obtained during a repository import, to correctly attribute commits. | | `mark-thread-as-done` | Marks the GitHub notification thread (identified by `thread_id`) as done or read for the authenticated user, effectively archiving it. | | `mark-thread-as-read` | Marks an existing GitHub notification thread, identified by its `thread_id`, as read. | | `mark-notifications-as-read` | Marks notifications as read or unread, optionally for those updated at or before a `last_read_at` timestamp. | | `mark-pull-request-ready-for-review` | Marks a draft pull request as ready for review using GitHub GraphQL API, transitioning it from draft to reviewable state. | | `mark-repository-notifications-as-read` | Marks notifications in a repository as read; if 'last\_read\_at' is specified, notifications updated after this timestamp are not marked as read. | | `merge-branch` | Merges a head branch or commit SHA into a base branch in a repository; fails if there are merge conflicts requiring manual resolution. | | `merge-pull-request` | Merges an open and mergeable pull request in a repository. A 405 error can occur for multiple reasons: (1) The PR is still in draft mode - convert it... | | `move-project-card` | Moves a project card to a specified position within a column (GitHub Classic Projects). | | `move-project-column` | Moves a column within a GitHub project (classic) to a new position. | | `ping-organization-webhook` | Sends a 'ping' event to a specified, existing organization webhook to test its configuration and ensure it correctly receives events. | | `ping-repository-webhook` | Pings an existing webhook on a repository to test its configuration and reachability by GitHub. | | `privately-report-security-vulnerability` | Privately reports a security vulnerability to a repository's maintainers. | | `publish-sponsors-tier-graph-ql` | Tool to publish a draft GitHub Sponsors tier using GraphQL. Use when you need to make a draft sponsors tier visible to potential sponsors. | | `redeliver-delivery-for-organization-webhook` | Redelivers a specific webhook delivery for a webhook within an organization, to resend an event that previously failed or was not processed. | | `redeliver-delivery-for-repository-webhook` | Redelivers a specific, previously made webhook delivery (`delivery_id`) for a repository's webhook (`hook_id`). | | `remove-custom-property-for-organization` | Deletes a custom property, specified by `custom_property_name`, from an existing organization (`org`) for which the property is currently defined... | | `remove-label-from-issue` | Removes a label currently applied to a specific issue in a repository. | | `remove-all-labels-from-issue` | Removes all labels from a specified issue in a GitHub repository; this operation is idempotent. | | `remove-all-organization-roles-for-team` | Revokes all organization roles for a team in an organization; this is destructive and succeeds even if the team initially has no roles. | | `remove-all-organization-roles-for-user` | Revokes all assigned organization-level roles from a specified user (who must be a member of the organization) within a GitHub organization, without... | | `remove-organization-member` | Removes a member from a GitHub organization. This action permanently removes a user's membership from the specified organization, revoking their... | | `remove-organization-role-from-team` | Revokes an organization role that a team currently possesses within an organization. | | `remove-organization-role-from-user` | Removes a custom organization role from a user within a GitHub organization, provided the organization exists, the user is a member, and the role\_id... | | `remove-app-access-restrictions` | Removes all GitHub App access restrictions from a protected branch in a repository; the branch must have protection rules configured, and this action... | | `remove-project-from-team` | Removes a project from a team within an organization; this action requires the project to be currently associated with the team. | | `remove-repository-collaborator` | Removes a collaborator from a specified GitHub repository, provided the repository exists and the user is an existing collaborator. | | `remove-repository-from-app-installation` | Removes a repository from a GitHub App installation for the authenticated user, given a valid `installation_id` and the `repository_id` of a... | | `remove-repository-from-team` | Disassociates a repository from a team; team members may lose access permissions, but the repository and team are not deleted. | | `remove-selected-repository-from-user-secret` | Removes a selected repository's access to a user's Codespaces secret; the secret must exist and the repository must have previously been granted access. | | `remove-assignees-from-issue` | Removes specified assignees from a GitHub issue; requires push access, and invalid removal attempts are silently ignored. | | `remove-custom-label-from-repo-runner` | Removes a custom label from a repository's self-hosted runner; this operation is idempotent. | | `remove-custom-label-from-self-hosted-runner` | Removes a currently assigned custom label (`name`) from a self-hosted runner (`runner_id`) in an organization (`org`). | | `remove-custom-labels-from-self-hosted-repo-runner` | Removes all custom labels from a self-hosted runner registered at the repository level, leaving only its default labels and any labels inherited from... | | `remove-interaction-restrictions-for-organization` | Removes all interaction restrictions from public repositories in the specified GitHub organization, allowing all users to resume interactions. | | `remove-interaction-restrictions-for-repository` | Removes all interaction restrictions for a repository, enabling all users to comment, open issues, and create pull requests by lifting any existing... | | `remove-org-dev-env-secret-by-name` | Deletes a GitHub Codespaces secret from an organization by its name; this operation is idempotent. | | `remove-org-secret-by-name` | Permanently removes a specific Dependabot secret, by its `secret_name`, from the GitHub `org`, making it unavailable to Dependabot for that organization. | | `remove-outside-collaborator-from-organization` | Removes a user, who must be an outside collaborator, from the specified GitHub organization, revoking their access to all its repositories. | | `remove-public-org-membership` | Removes the authenticated user's public organization membership, making it private. | | `remove-public-repo-interaction-restrictions` | Removes all interaction restrictions (limitations on comments, issues, or pull requests) from all public repositories owned by the authenticated user. | | `remove-repo-from-org-dev-env-secret` | Removes a repository's access to an organization-level Codespaces secret, if it was previously granted. | | `remove-repo-from-org-secret-with-selected-visibility` | Revokes a specific repository's access to an organization-level Dependabot secret, applicable only when the secret has 'selected' visibility and the... | | `remove-requested-reviewers-from-pull-request` | Removes currently assigned user logins and/or team slugs from a GitHub pull request's list of requested reviewers. | | `remove-review-request` | Removes requested reviewers from a pull request. Use this action when you need to cancel a review request that was previously sent to users or teams. | | `remove-selected-repo-from-org-secret` | Removes a specific repository's access to an organization-level secret; the repository must have been previously granted access to this secret. | | `remove-selected-repo-from-org-variable` | Removes a repository's access to an organization variable that has 'selected' visibility. | | `remove-status-check-contexts` | Removes specified status check contexts from a protected branch's required status checks. | | `remove-status-check-protection` | Removes status check protection from a branch, disabling required status checks for merging pull requests; will only have an effect if status check... | | `remove-team-access-restrictions` | Removes specified teams from push access to a protected branch. | | `remove-team-membership` | Tool to remove team membership for a user in an organization. | | `remove-team-membership-for-user` | Removes a user from a specific team within an organization. This action requires admin:org scope permissions. | | `remove-user-access-restrictions` | Removes specified users from the list of people allowed to push to a protected branch. | | `remove-user-as-collaborator` | Removes a user as a collaborator from an organization project (classic). | | `remove-users-codespaces-access-org` | Removes selected users from GitHub Codespaces billing access for an existing organization. | | `rename-branch` | Renames an existing branch in a GitHub repository; the new name must be unique and adhere to GitHub's naming conventions, and the current branch name... | | `render-markdown-document` | Renders Markdown to HTML; for 'gfm' mode, provide 'context' (owner/repo) to correctly link issues, pull requests, and user mentions. | | `render-markdown-raw` | Tool to render raw Markdown text to HTML using GitHub's markdown API. | | `reopen-issue` | Reopens a closed GitHub issue by changing its state to 'open' with state\_reason 'reopened'. | | `reopen-pull-request` | Reopens a previously closed pull request by setting its state to 'open'. | | `replace-all-repository-topics` | Replaces all topics of a repository. | | `replace-org-secret-visibility-to-selected` | Replaces the list of repositories that can access a Dependabot organization secret when the secret's visibility is already set to 'selected'. | | `replace-repo-access-on-org-dev-env-secret-set` | Replaces the list of repositories that can access an organization-level Codespaces secret. | | `request-pages-build` | Manually triggers a GitHub Pages build for a repository if GitHub Pages is enabled, useful for deployments not automatically built or for retrying failed builds. | | `request-reviewers` | Requests reviewers for a specific pull request identified by owner, repository, and pull request number. | | `request-reviewers-for-pull-request` | Adds reviewers to a specific pull request identified by owner, repo, and pull\_number. | | `rerequest-check-run` | Triggers a re-run of a specific check run in a GitHub repository, resetting its status to 'queued', clearing its conclusion, and triggering the... | | `rerequest-check-suite` | Triggers a new run of an existing check suite within a repository, resetting its status to 'queued', clearing its conclusion, and triggering the... | | `re-run-job-from-workflow-run` | Re-runs a specific job and any dependent jobs from a GitHub Actions workflow run in the specified repository, optionally enabling debug logging. | | `re-run-workflow` | Re-runs a specific GitHub Actions workflow run identified by its owner, repository, and run ID, optionally enabling debug logging. | | `re-run-failed-jobs-from-workflow-run` | Re-runs all failed jobs and their dependent jobs from a specified workflow run if the run contains previously failed jobs. | | `reset-token` | Invalidates the provided OAuth `access_token` and generates a new one for the GitHub OAuth App identified by `client_id`. | | `restore-package-for-organization` | Restores a package in an organization, provided it was deleted within the last 30 days. | | `restore-package-for-user` | Restores a user-owned package previously deleted from GitHub Packages, if restorable under GitHub's data retention policy (typically within 30 days of deletion). | | `restore-package-for-authenticated-user` | Restores a package deleted by the authenticated user within the last 30 days, if its namespace and version are still available. | | `restore-package-version-for-authenticated-user` | Restores a package version that was deleted by the authenticated user within the last 30 days. | | `restore-package-version-for-organization` | Restores a package version for an organization, provided it was deleted within the last 30 days. | | `restore-package-version-for-user` | Restores a specific, user-owned package version if it was deleted within the last 30 days and its original namespace and version name are still available. | | `retire-sponsors-tier` | Tool to retire a published payment tier from your GitHub Sponsors profile using GraphQL. | | `review-access-with-personal-token` | Approves or denies a pending fine-grained personal access token request for organization resources; must be performed by a GitHub App. | | `review-deployment-protection-rules` | Approves or rejects pending custom deployment protection rules for a workflow run. | | `review-pending-deployments-for-workflow-run` | Approves or rejects pending deployments for a specific workflow run that are in a 'waiting' state within specified, configured environments. | | `review-resource-requests-with-fine-grained-tokens` | Approves or denies multiple fine-grained personal access token requests for an organization in bulk. | | `revoke-installation-access-token` | Revokes the GitHub App's current installation access token, immediately invalidating it for API authentication. | | `run-graph-ql-query` | Tool to run an arbitrary GitHub GraphQL v4 query or mutation. | | `run-graph-ql-relay-query` | Tool to run a GitHub GraphQL relay query. The relay field is a workaround for re-exposing the root query object. | | `search-code` | Searches code file contents and paths on the default branch of GitHub repositories using a query string; searches only files under 384KB, returns max... | | `search-code-all-pages` | Tool to search code across multiple pages using GitHub's code search API. | | `search-commits` | Finds commits on GitHub using a query string (q) supporting keywords and qualifiers, with options for sorting and pagination. | | `search-commits-by-author` | Searches commits across GitHub using the Search API (e.g., by author/email/org/date range) without per-repo scanning. | | `search-graphql` | Tool to perform GitHub GraphQL searches across issues, pull requests, repositories, users, and discussions. | | `search-issues` | Searches GitHub issues and pull requests using a flexible query with qualifiers, sorting, and pagination. | | `search-issues-and-pull-requests` | Searches GitHub for issues and pull requests. Supports keywords, qualifiers (repo:, org:, user:, state:, label:, author:, assignee:, mentions... | | `search-labels` | Searches for labels within a GitHub repository by keywords in their names or descriptions. | | `search-repositories` | Searches GitHub repositories using a flexible query (keywords, qualifiers) with sorting, ordering, and pagination. | | `search-topics` | Finds topics on GitHub using keywords and qualifiers with GitHub's search syntax, supporting pagination. | | `search-users` | Searches for users on GitHub by criteria like username, email, location, followers, or repository associations, using a flexible query string `q`. | | `set-admin-branch-protection` | Enables administrator enforcement on a branch, making existing protection rules also apply to administrators; branch protection rules must already be configured. | | `set-app-access-restrictions` | Replaces the list of GitHub Apps permitted to push to a protected branch. | | `set-repository-subscription` | Sets the authenticated user's notification subscription for a repository. | | `set-thread-subscription` | Sets whether a GitHub notification thread is ignored (muted) or unignored (unmuted), for a `thread_id` that must identify an existing notification thread. | | `set-default-workflow-permissions-for-organization` | Updates an organization's default GITHUB\_TOKEN permissions for workflows and whether GitHub Actions can approve pull requests; note that allowing... | | `set-default-workflow-permissions-for-repository` | Sets the default permissions for the GITHUB\_TOKEN within a repository and configures whether GitHub Actions can approve pull requests. | | `set-email-visibility` | Sets the visibility ('public' or 'private') of the authenticated user's primary email address on GitHub, if one is configured. | | `set-actions-permissions-for-organization` | Sets the GitHub Actions permissions policy for an organization, specifying which repositories can run Actions and which actions/workflows are... | | `set-actions-permissions-for-repository` | Sets GitHub Actions permissions for a repository, enabling/disabling Actions and defining the policy for allowed actions and reusable workflows. | | `set-interaction-restrictions-for-organization` | Limits interactions (comments, new issues, PRs) in an organization's public repositories by user type and duration, typically to mitigate high... | | `set-interaction-restrictions-for-repository` | Temporarily limits which GitHub users (e.g., existing\_users, contributors\_only) can interact (comment, open issues, create pull requests) in a... | | `set-interaction-restrictions-for-your-public-repos` | Sets or updates temporary interaction restrictions for all public repositories owned by the authenticated user, overriding any repository-specific limits. | | `set-labels-for-issue` | Replaces all existing labels on a GitHub issue with a new set of labels. | | `set-oidc-subject-claim-template` | Sets the OpenID Connect (OIDC) subject claim template for a GitHub repository, allowing use of the default template or a custom one defined by... | | `set-org-allowed-actions` | Sets the GitHub Actions permissions for an existing organization, specifying allowed GitHub-owned actions, verified creator actions, and... | | `set-org-runner-labels` | Sets the custom labels for a self-hosted runner in an organization; this operation does not affect default system-assigned labels (e.g., 'self-hosted', 'linux', 'x64'). | | `set-repo-allowed-actions` | Sets allowed GitHub Actions and reusable workflows for a repository, managing permissions for GitHub-owned, verified creator, or specific... | | `set-repo-runner-labels` | Replaces all custom labels for a specific self-hosted runner in a repository; an empty list for `labels` removes all existing custom labels. | | `set-selected-repos-for-org-variable` | Replaces the list of repositories that can access an organization-level variable; the variable's visibility must be 'selected'. | | `set-selected-repositories-for-organization-secret` | Replaces the list of repositories that can access an organization secret; only effective if the secret's visibility is 'selected'. | | `set-selected-repositories-for-user-secret` | Defines the list of repositories permitted to access a specific Codespaces secret for the authenticated user. | | `set-status-check-contexts` | Replaces required status check contexts for a protected branch, requiring admin permissions; an empty `contexts` array removes all checks. | | `set-team-access-restrictions` | Replaces the list of teams with push access to a protected branch. | | `set-user-access-restrictions` | Replaces the list of users with push access to a protected branch in an organization repository. | | `set-user-interaction-limit-graph-ql` | Tool to set interaction limits on a user's public repositories using GraphQL. | | `set-workflow-external-access` | Sets the access level for workflows outside a repository to use actions and reusable workflows within that repository. | | `star-gist` | Stars a GitHub gist identified by `gist_id`; this action is idempotent and returns a 204 No Content status upon success, even if the gist is already starred. | | `star-repository-for-authenticated-user` | Stars a specified repository (identified by owner and repo name) for the authenticated user; this action is idempotent and succeeds even if the... | | `start-codespace-for-authenticated-user` | Initiates the startup process for an existing GitHub Codespace (identified by `codespace_name`) if it's in a startable state like 'Available' or 'Stopped'. | | `stop-codespace-for-organization-user` | Stops a running codespace for an organization member. This action allows organization administrators to stop a codespace that belongs to a member of their organization. | | `stop-codespace-for-authenticated-user` | Stops a running or available Codespace for the authenticated user, pausing its execution and billing. | | `submit-review-for-pull-request` | Finalizes a pending pull request review (identified by `review_id`) with a required `event` (APPROVE, REQUEST\_CHANGES, COMMENT) and an optional `body`. | | `sync-fork-branch-with-upstream` | Synchronizes a branch in a forked GitHub repository with its upstream counterpart, assuming the repository is a fork, the branch exists, an upstream... | | `test-repository-webhook` | Triggers a simulated push event to test a repository's push webhook; a test event is only delivered if the webhook is subscribed to 'push' events... | | `transfer-repository` | Initiates a repository transfer to a new owner (who must accept the request); if the new owner is an organization, it must be configured to allow transfers. | | `unblock-user` | Unblocks a GitHub user, provided they are currently blocked by the authenticated user. | | `unblock-user-from-organization` | Unblocks a user from an organization, allowing renewed interaction with its resources, provided the user is currently blocked (otherwise, a 404 error may occur). | | `unfollow-user` | Tool to unfollow a GitHub user using GraphQL. Use when you need to stop following a specific user on GitHub. | | `unfollow-organization` | Tool to unfollow a GitHub organization using GraphQL. Use when you need to stop following a specific organization on GitHub. | | `unlock-issue` | Unlocks a currently locked GitHub issue in the specified repository, allowing new comments and interactions. | | `unlock-organization-repository` | Unlocks a repository that was locked for migration within a GitHub organization. | | `unlock-user-repository` | Unlocks a repository (`repo_name`) that was locked as part of a user migration (`migration_id`), making it usable or deletable; this action requires... | | `unstar-gist` | Removes a star from the specified gist; the action is idempotent and will not error if the gist was not previously starred by the user. | | `unstar-repository` | Removes the authenticated user's star from a specified repository, which must already be starred by the user. | | `update-check-run` | Updates an existing check run for a specific commit in a repository, allowing modifications to its status, conclusion, output, and other details. | | `update-code-scanning-alert` | Updates a specific code scanning alert in a GitHub repository, primarily to change its state (e.g., 'open' or 'dismissed'). | | `update-commit-comment` | Changes the body of an existing commit comment. | | `update-custom-organization-role` | Updates an existing custom role in an organization by modifying its name, description, or permissions; at least one of these fields must be provided. | | `update-deployment-branch-policy` | Updates the name pattern of an existing deployment branch policy for a specific environment in a repository. | | `update-discussion` | Updates the title and/or body of a specific team discussion within an organization. | | `update-discussion-comment` | Updates the body of a comment in a team's discussion within an organization. | | `update-gist` | Updates a gist's description, and/or its files (including content, filename changes, or deletion). | | `update-gist-comment` | Updates an existing comment on a specified gist. | | `update-label` | Updates an existing label's name, color, or description within a specified repository. | | `update-milestone` | Updates a milestone in a repository, identified by `owner`, `repo`, and `milestone_number`, by allowing modification of its `title`, `state`... | | `update-environment-variable` | Updates an existing environment variable's name and/or value in a specific GitHub repository environment; requires providing either a new name or a new value. | | `update-issue` | Updates an existing GitHub issue's title, body, state, milestone, labels, or assignees; `state_reason` is only processed if `state` also changes, and... | | `update-issue-comment` | Updates an existing comment on an issue or pull request within a specified repository. | | `update-organization` | Updates an organization's settings; changing security-related fields requires admin, owner, or security manager permissions. | | `update-organization-variable` | Updates an existing GitHub Actions organization variable's name, value, or visibility (`all`, `private`, `selected`), requiring... | | `update-organization-webhook` | Updates the configuration (URL, content type, secret, SSL verification), subscribed events, active status, or name of an existing webhook for a specified organization. | | `update-project` | Updates an existing GitHub project (V2) attributes like title, description, visibility, and state. | | `update-pull-request` | Updates an existing pull request, allowing changes to attributes like title, body, state, base branch, and maintainer modification settings. | | `update-pull-request-branch` | Updates an open pull request's head branch by merging the latest changes from its base branch, if mergeable and repository merging is enabled; operates asynchronously. | | `update-reference` | Updates an existing Git reference (e.g., a branch or tag) to point to a specific commit SHA. | | `update-release` | Updates an existing release in a GitHub repository, allowing modification of its attributes; if linking a discussion, the `discussion_category_name`... | | `update-release-asset` | Updates the name, label, or state of a release asset in a GitHub repository, requiring at least one of these properties to be provided for modification. | | `update-repository` | Updates settings for an existing GitHub repository, such as name, description, visibility, merge strategies, and security configurations. | | `update-repository-invitation` | Updates an active repository invitation to modify the invited user's permissions; the specified repository and invitation must exist. | | `update-repository-ruleset` | Updates an existing repository ruleset, identified by `ruleset_id` for a given repository, allowing partial updates to its configuration such as... | | `update-repository-variable` | Updates the name and/or value of an existing GitHub Actions variable in a repository. | | `update-repository-webhook` | Updates the URL, content type, secret, SSL verification, events, or active status for an existing repository webhook, specified by `owner`, `repo`, and `hook_id`. | | `update-team` | Updates a team's settings (e.g., name, description, privacy, parent team) within a GitHub organization, identified by its slug and organization name. | | `update-branch-protection` | Updates the protection settings for an existing branch in a repository, which must not contain wildcard characters. | | `update-code-scanning-default-setup` | Updates the default setup configuration for code scanning in a repository; GitHub Advanced Security must be enabled for the repository. | | `update-codespace` | Updates an existing GitHub Codespace's machine type, display name, or recent folders for the authenticated user; machine type changes take effect on the next start. | | `update-git-lfs-preference` | Sets the Git Large File Storage (LFS) preference for a repository during a source import. | | `update-issue-type` | Update an existing issue type for a GitHub organization. Requires the authenticated user to be an organization administrator. | | `update-organization-webhook-configuration` | Updates the configuration (URL, content type, secret, SSL verification) for an existing webhook within a specified organization. | | `update-project-card` | Updates an existing project card's note and/or archived status (GitHub Classic Projects). | | `update-project-column` | Updates the name of an existing column, identified by `column_id`, in a GitHub project (classic). | | `update-pull-request-review` | Updates the body text of an existing pull request review. | | `update-pull-request-review-comment` | Updates the body of an existing review comment on a pull request. | | `update-pull-request-review-protection` | Updates pull request review protection settings (e.g., required approvals, review dismissal, bypass allowances) for a branch; branch protection... | | `update-repository-preferences-for-check-suites` | Updates repository preferences for automatic Check Suite creation on code pushes, allowing configuration for specific GitHub Apps that must be... | | `update-repository-webhook-configuration` | Updates the configuration (e.g., payload URL, content type, secret, SSL verification) for an existing webhook in a specified repository. | | `update-resource-access-with-tokens` | Revokes organization access for the personal access tokens identified by `pat_ids`; this action must be performed by a GitHub App, and `pat_ids` must... | | `update-status-check-protection` | Updates required status checks for a branch, optionally requiring it to be up-to-date before merging. | | `update-subscription` | Tool to update notification subscription state for issues, pull requests, or discussions. | | `update-authenticated-user` | Updates the authenticated user's GitHub profile; a new public email must be verified, and existing private emails remain private even if specified. | | `update-token-org-access` | Revokes a fine-grained personal access token's access to an organization. | | `update-user-list` | Tool to update an existing GitHub user list. Use when you need to modify the name, description, or privacy settings of a user list. | | `update-user-lists-for-item` | Tool to update which of the viewer's lists an item belongs to on GitHub. | | `update-user-project-item` | Tool to update a field value for an item in a user's GitHub ProjectV2. | | `update-user-status` | Tool to update your status on GitHub. Use when you need to set or clear your GitHub profile status with an emoji, message, and availability indicator. | | `upload-release-asset` | Tool to upload a binary asset to an existing GitHub release. | | `upload-sarif-analysis` | Uploads a gzipped and Base64 encoded SARIF file to a GitHub repository for a specific commit and reference; use `checkout_uri` if SARIF paths are absolute. | | `upsert-repo-custom-property-values` | Creates or updates up to 30 custom property values for a repository; custom properties must be predefined at the organization or repository level... | | `validate-credential` | Validates GitHub API credentials by checking if they can successfully authenticate. | | `verify-dev-container-permissions-accepted` | Verifies if the authenticated user has accepted permissions for a specific devcontainer configuration in a repository, typically to ensure awareness... | ## Triggers (46) Subscribe with `.on(...)` in a script. A trigger with required configuration takes it as the second argument. | Trigger | Needs | What fires it | | --------------------------------------- | -------------------------------- | ------------------------------------------------------------------------------------ | | New Workflow Artifact Created | `owner`, `repo` | Triggers when a new workflow artifact is created in a GitHub repository. | | Branch Changed | `owner`, `repo`, `branch` | Triggers when a GitHub branch changes. | | New Branch Created | `owner`, `repo` | Triggers when a new branch is created in a GitHub repository. | | Check Run Status / Conclusion Changed | `owner`, `repo`, `check_run_id` | Triggers when a specific GitHub check run changes its status or conclusion. | | Check Suite Status / Conclusion Changed | `owner`, `repo`, `ref` | Triggers when a GitHub check suite changes its status or conclusion for a given ref. | | New Code Scanning Alert Created | `owner`, `repo` | Triggers when a new code scanning alert is created in a repository. | | New Repository Collaborator Added | `owner`, `repo` | Triggers when a new collaborator is added to a GitHub repository. | | Commit Event | `owner`, `repo` | Triggered when a new commit is pushed to a repository. | | New Deployment Created | `owner`, `repo` | Triggers when a new deployment is created in a GitHub repository. | | GitHub Deployment State Changed | `owner`, `repo`, `deployment_id` | Triggers when a specific GitHub deployment's fields change. | | New Deployment Status Created | `owner`, `repo`, `deployment_id` | Triggers when a new deployment status is created for a specific deployment. | | Follower Changes | nothing | Triggers when new followers are detected on your GitHub account. | | New Git Reference Created | `owner`, `repo`, `ref_prefix` | Triggers when a new Git reference (branch or tag) matching a specified | | Issue Added Event | `owner`, `repo` | Triggered when a new issue is added to the repository. | | New Issue Assigned to Me | nothing | Triggers when a new issue is assigned to the authenticated user. | | GitHub Issue Comment Changed | `owner`, `repo`, `comment_id` | Triggers when a specific GitHub issue comment changes. | | New GitHub Issue Comment | `owner`, `repo`, `issue_number` | Triggers when a new comment is added to a specific GitHub issue. | | New Issue Created | `owner`, `repo` | Triggers when a new issue is created in a GitHub repository. | | New Issue Event | `owner`, `repo` | Triggers when a new issue event occurs in a GitHub repository. | | GitHub Issue Labels Changed | `owner`, `repo`, `issue_number` | Triggers when the labels on a specific GitHub issue change. | | Issue State / Properties Changed | `owner`, `repo`, `issue_number` | Triggers when a specific GitHub issue changes any of its tracked properties. | | Issue Updated | `owner`, `repo` | Triggers when an existing issue is updated in a GitHub repository. | | Label Added Event | `owner`, `repo` | Triggered when a new label is added to a pull request. | | New Stargazer Added | `owner`, `repo` | Triggers when a new user stars a GitHub repository. | | New Pull Request Review Comment | `owner`, `repo`, `pull_number` | Triggers when a new inline review comment is added to a specific GitHub | | New Commit Added to Pull Request | `owner`, `repo`, `pull_number` | Triggers when a new commit is pushed to a specific pull request. | | New Pull Request Created | nothing | Triggers when a new pull request is created in GitHub, matching the | | Pull Request Event | `owner`, `repo` | Triggered when a pull request is opened, closed, or synchronized. | | GitHub Pull Request Reviewers Changed | `owner`, `repo`, `pull_number` | Triggers when the list of requested reviewers (users or teams) for a pull | | Pull Request Review Submitted | `owner`, `repo`, `pull_number` | Triggers when a new review is submitted for a GitHub pull request. | | Pull Request State / Properties Changed | `owner`, `repo`, `pull_number` | Triggers when a specific GitHub pull request changes any of these tracked | | Pull Request Updated | `owner`, `repo` | Triggers when an existing pull request is updated in a GitHub repository. | | GitHub Repository README Changed | `owner`, `repo` | Triggers when the README file in a specific repository directory changes. | | New GitHub Release Asset Added | `owner`, `repo`, `release_id` | Triggers when a new asset is added to a specific GitHub release. | | GitHub Release State Changed | `owner`, `repo`, `tag` | Triggers when a specific GitHub release (identified by tag name) changes. | | Repository Content Changed | `owner`, `repo` | Triggers when the content of a file or directory in a GitHub repository | | Repository Notification Received | `owner`, `repo` | Triggers when a new or newly updated notification thread appears for a | | New Repository Tag Created | `owner`, `repo` | Triggers when a new tag is created in a GitHub repository. | | New Secret Scanning Alert Detected | `owner`, `repo` | Triggers when a new secret scanning alert is detected in a GitHub repository. | | Star Added Event | `owner`, `repo` | Triggered when a new star is added to the repository. | | New GitHub Actions Workflow Added | `owner`, `repo` | Triggers when a new GitHub Actions workflow is added to a repository. | | New Workflow Job Added | `owner`, `repo`, `run_id` | Triggers when a new job appears in a specific GitHub Actions workflow run. | | Workflow Job State Changed | `owner`, `repo`, `job_id` | Triggers when the status, conclusion, timestamps, runner assignment, or step | | New Artifact Added to Workflow Run | `owner`, `repo`, `run_id` | Triggers when a new artifact is uploaded to a specific GitHub Actions workflow run. | | New Workflow Run Created | `owner`, `repo` | Triggers when a new workflow run is created in a GitHub repository. | | GitHub Workflow Run State Changed | `owner`, `repo`, `run_id` | Triggers when a GitHub Actions workflow run's status or conclusion changes. | [Open GitHub in the console →](https://app.boxd.sh/integrations/detail/github)