GitHub

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

run auth github
run auth github --scope team    # shared with the organization

Or from the Integrations page in the console. See Connections for personal versus shared, and who may remove one.

Use it

run github          # common commands
run github --all    # every command

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.

All 890 tools

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 →

Getting started

Guides

Integrations and automations

Use cases

References

Connect it

Use it

Common tools

Triggers (46)

​Connect it

​Use it

​Common tools

​Triggers (46)

Connect it

Use it

Common tools

Triggers (46)