Your AI team, working in GitHub
GitHub is a code hosting platform for version control and collaboration, offering Git-based repository management, issue tracking, and continuous integration features
Start your companyWhat your team can do in GitHub
891 tools to work with, connected with your account.
Tool to abort a repository migration that is queued or in progress. Use when you need to cancel an ongoing migration operation.
Accepts a PENDING repository invitation that has been issued to the authenticated user.
Adds a GitHub user as a repository collaborator, or updates their permission if already a collaborator; `permission` applies to organization-owned repositories (personal ones default to 'push' and ignore this field), and an invitation may be created or permissions updated directly.
Adds a repository to a GitHub App installation, granting the app access; requires authenticated user to have admin rights for the repository and access to the installation.
Grants a specified repository access to an authenticated user's existing Codespaces secret, enabling Codespaces created for that repository to use the secret.
Adds GitHub Apps to the list of apps allowed to push to a protected branch. The branch must already have protection rules with restrictions enabled. This endpoint only works for organization repositories, not personal repositories. Apps must be installed on the repository with 'contents' write permissions.
Adds assignees to a GitHub issue. This action only adds users - it does not remove existing assignees. Changes are silently ignored if the authenticated user lacks push access to the repository.
Adds one or more email addresses (which will be initially unverified) to the authenticated user's GitHub account; use this to associate new emails, noting an email verified for another account will error, while an existing email for the current user is accepted.
Tool to add a custom field to a user-owned GitHub Projects V2 project. Use when you need to add fields like status, priority, or custom data to organize project items.
Tool to add an issue or pull request to a user-owned GitHub project. Use when you need to add existing repository items to a project board.
Adds labels (provided in the request body) to a repository issue; labels that do not already exist are created.
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, returning current details if no change is made.
Adds a classic organization project to a team or updates the team's permissions. GitHub sunset the Projects (classic) REST API on April 1, 2025; this does not manage Projects V2.
Sets or updates a team's permission level for a repository within an organization; the team must be a member of the organization.
Adds new custom labels to an existing self-hosted runner for an organization; existing labels are not removed, and duplicates are not added.
Adds a GitHub user as a collaborator to an organization project (classic) with a specified permission level. The Projects (classic) REST API was sunset on GitHub.com on April 1, 2025; adding collaborators requires organization-owner or project-admin access.
Adds a repository to an existing organization-level GitHub Actions secret that is configured for 'selected' repository access.
Adds reviewers to a specific pull request identified by owner, repo, and pull_number. This is NOT a search action - it operates on an already-known PR number. Requires `owner`, `repo`, `pull_number`, and at least one of `reviewers` or `team_reviewers`.
Adds and appends custom labels to a self-hosted repository runner, which must be registered and active.
Grants an existing repository access to an existing organization-level Dependabot secret when the secret's visibility is set to 'selected'; the repository must belong to the organization, and the call succeeds without change if access already exists.
Adds a repository to the access list of an organization-level GitHub Codespaces secret with selected visibility.
Grants a repository access to an organization-level GitHub Actions variable, if that variable's visibility is set to 'selected_repositories'.
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.
Adds status check contexts to a protected branch's required status checks. This action appends new status check contexts to the existing list of required status checks for a protected branch. The branch must already have branch protection enabled with status checks configured. Note: The 'contexts' parameter is deprecated by GitHub in favor of 'checks' array. For new implementations, consider using update_status_check_protection with the 'checks' parameter instead.
Tool to add a sub-issue to a parent GitHub issue using GraphQL. Use when you need to establish a parent-child relationship between issues. Requires the 'sub_issues' GraphQL feature to be enabled.
Adds teams to the list of teams with push access to a protected branch. This action grants additional teams push access to a protected branch. Unlike 'Set team access restrictions' (PUT), this action adds to the existing list rather than replacing it entirely. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must exist in the organization and have repository access
Adds users to the list of people allowed to push to a protected branch in an organization repository. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must already have protection rules with restrictions enabled - Users must have write access to the repository to be added - The combined total of users, apps, and teams is limited to 100 items
Adds organization members to the list of users granted Codespaces access billed to the organization. IMPORTANT: This endpoint requires the organization's Codespaces billing access to be set to 'selected_members' mode. If not already configured, use the GITHUB_MANAGE_ACCESS_CONTROL_FOR_ORGANIZATION_CODESPACES action first to set visibility to 'selected_members'.
Approves a workflow run from a forked repository's pull request; call this when such a run requires manual approval due to workflow configuration.
Assigns an existing organization-level role (identified by `role_id`) to a team (identified by `team_slug`) within a GitHub organization (`org`), provided the organization, team, and role already exist.
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.
Blocks an existing individual GitHub user (not an organization or your own account), preventing them from interacting with your account and repositories.
Blocks a GitHub user from an organization, preventing contributions, collaboration, and forking of its repositories; requires admin or 'Blocking users' organization permission. Certain permission and validation errors return a response with success=false.
Cancels an existing, ongoing or queued GitHub Pages deployment for a repository using its `pages_deployment_id`.
Requests cancellation of a workflow run in a GitHub repository if it is in a cancellable state, such as in progress or queued. Returns an acceptance message when GitHub accepts the request; cancellation may take time to complete.
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. Either sponsor ID/login and sponsorable ID/login must be provided.
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.
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. NOTE: This endpoint requires Basic Authentication using the OAuth App's client_id as username and client_secret as password. The access_token parameter must be an OAuth token issued by the specified OAuth App.
Checks whether the authenticated user has starred a GitHub gist. Returns true for HTTP 204 or 304 and false for HTTP 404; an unexpected successful status also yields false with a status message.
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 empty 'data' field in the response.
Checks if a specified GitHub user can be assigned to a given issue within a repository.
Checks if a GitHub user `username` follows `target_user`; returns a 204 HTTP status if true, 404 if not or if users are invalid.
Checks whether a user is a collaborator on a GitHub repository, returning a boolean for HTTP 204 or 404; a 404 can also mean the repository or user does not exist. A 403 returns an indeterminate result with a permission error.
Checks whether a GitHub user is blocked by an organization; requires 'Blocking users' organization permission (read access). Returns is_blocked=True for HTTP 204, False for HTTP 404, and a null status with an error for HTTP 403.
Checks whether a specified GitHub user is blocked by the authenticated user. Both a blocked response and a 404 response are returned as an empty result, so the result does not distinguish those cases.
Check if the authenticated user is following a specified person on GitHub. Use this action when you need to verify whether the currently authenticated user follows another GitHub user. The action returns a boolean status and descriptive message.
Checks if the authenticated GitHub user follows a target GitHub user. Returns a structured response with is_following=True when following (HTTP 204), or is_following=False when not following (HTTP 404).
Checks if a specified GitHub pull request has been merged, indicated by a 204 HTTP status (merged) or 404 (not merged/found).
Checks whether a GitHub pull request has been merged. Returns merged=True for HTTP 204 and merged=False for HTTP 404; a 404 can also mean the pull request does not exist.
Checks whether the authenticated user has starred a specified GitHub repository. This action is deprecated.
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 dictionary in the response data); the action fails (e.g., HTTP 404) if the repository is not starred or does not exist.
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. This is useful for confirming star status before performing star/unstar operations or displaying repository status.
Check whether a user has membership visible to the connected account. GitHub documents 404 as a negative result only when the requester is an organization member. It can otherwise indicate hidden membership, insufficient access, or a missing organization or user.
Checks if private vulnerability reporting is enabled for the specified repository.
Check whether a user is a public member of a GitHub organization. A 404 is reported as not a public member, but may also indicate that the user or organization does not exist.
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.
Checks a team's permissions for a specific repository within an organization, including permissions inherited from parent teams.
Tool to clear the value of a field for an item in a GitHub Project V2. Use when you need to remove or reset a field value (text, number, date, assignees, labels, single-select, iteration, or milestone fields).
Deletes GitHub Actions caches from a repository matching a specific `key` and an optional Git `ref`, used to manage storage or clear outdated/corrupted caches; the action succeeds even if no matching caches are found to delete.
Removes all custom labels from a self-hosted runner for an organization; default labels (e.g., 'self-hosted', 'linux', 'x64') will remain.
Closes an open pull request without merging it. The pull request state is set to "closed" and it can be reopened later if needed. Use this action when you want to reject or abandon a pull request without merging the proposed changes into the base branch. You must have write access to the repository to close pull requests.
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. Optionally specify a reason for closing (completed or not_planned) to provide context.
Creates, updates, or deletes repository files in a commit, with retries for non-fast-forward branch updates; a new branch in a nonempty repository requires a base branch. Empty repository initialization creates separate commits per file and may also write an initialization file to the default branch.
Compares two commit points (commits, branches, tags, or SHAs) within a repository or across forks, using `BASE...HEAD` or `OWNER:REF...OWNER:REF` format for the `basehead` parameter.
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 the runner_group_id must exist in the organization.
Sets or updates the OIDC subject claim customization template for an existing GitHub organization by specifying which claims (e.g., 'repo', 'actor') form the OIDC token's subject (`sub`). This action customizes which claim keys are included in the OIDC subject claim for the specified organization. It allows for fine-tuning the content of the subject claim based on organizational needs.
Converts a GitHub organization member to an outside collaborator with access restricted to explicitly granted repositories. The conversion can be requested asynchronously; queued and completed responses are both returned as empty results.
Converts an open pull request to draft status, indicating it is not ready for review. Use this action when you need to mark a PR as work-in-progress after it has been opened. Draft pull requests cannot be merged until they are marked as ready for review. This action is useful when additional work is needed before the PR can be reviewed or merged.
Creates a Git blob in a repository, requiring content and encoding ('utf-8' or 'base64'). Requires write access to the repository.
Creates a new branch in a GitHub repository pointing to a specified commit. Use this action when you need to create a new branch from an existing commit SHA. IMPORTANT: This action only creates NEW branches. If the branch already exists, it will fail with a 422 'Reference already exists' error. The repository must not be empty (must have at least one commit) before creating a branch.
Creates a new check run for a specific commit in a repository, used by external services to report status, detailed feedback, annotations, and images directly within the GitHub UI. NOTE: This endpoint requires GitHub App authentication - OAuth tokens and personal access tokens cannot create check runs.
Creates a new check suite for a specific commit (`head_sha`) in an original repository (not a fork). IMPORTANT: This endpoint requires a GitHub App installation access token - OAuth tokens and classic personal access tokens cannot use this endpoint. GitHub dispatches a `check_suite` webhook event with the `requested` action upon success.
Creates a GitHub Codespace for the authenticated user, requiring a JSON request body with either `repository_id` (integer) or a `pull_request` object (containing `pull_request_number` (integer) and `repository_id` (integer)). This action allows users to set up a development environment quickly by creating a codespace from a specified repository or pull request.
Creates a GitHub Codespace for an open pull request in a Codespaces-enabled repository, with options to customize its configuration.
Creates a GitHub Codespace for the authenticated user in a specified repository, which must be accessible and use a valid `devcontainer.json` if `devcontainer_path` is specified.
Creates a Git commit object in a GitHub repository using an existing tree SHA and optional existing parent commit SHAs. It does not update a branch reference.
Creates a comment on a specific commit, or on a specific line if `path` and `position` are provided.
Sets a commit's status (e.g., error, failure, pending, success from CI/CD) for a given SHA; max 1000 statuses per SHA/context.
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.
Creates a custom role with defined permissions within a GitHub organization.
Creates a snapshot of a repository's dependencies to populate the GitHub dependency graph and enable security alerts; `sha` must be a 40-character commit ID, `ref` a fully qualified Git reference (e.g., `refs/heads/main`), and `scanned` an ISO 8601 timestamp.
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.
Creates a GitHub deployment for an existing repository, targeting a specific ref (branch, tag, or SHA). By default, it may attempt to merge the default branch into the requested ref if it is behind.
Creates a deployment branch or tag policy for an existing environment in a GitHub repository, using a Ruby File.fnmatch pattern (where `*` doesn't match `/`) to specify which branches or tags are deployable.
Creates a status for an existing deployment, updating its operational state, associated URLs, and description.
Creates a new discussion post on a specific team's page within an organization.
Creates a new comment on an existing team discussion within a GitHub organization.
Creates a fork of an accessible repository, optionally into a specific organization, with a new name, or copying only the default branch.
Creates a new gist on GitHub with provided files, an optional description, and public/secret visibility.
Creates a new comment on a specified GitHub gist.
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 configuration, including credentials and private key. The code is provided via redirect URL after creating the app through GitHub's web interface and must be used within 1 hour.
Creates a GitHub Pages deployment for a repository using a specified artifact and OIDC token, provided GitHub Pages is enabled and the artifact (containing static assets) is accessible.
Creates a GitHub Pages site for a repository, with a choice of build type and source location.
Creates a label in a specified GitHub repository, provided the repository exists and the user has write permissions. If the label name already exists, it may return a message instead of creating a label.
Creates a milestone in a GitHub repository for tracking progress on issues or pull requests; requires repository existence and user write permissions.
Creates a pull request in a GitHub repository, requiring existing `base` and `head` branches; `title` or `issue` must be provided.
Creates a NEW Git reference (branch or tag) in a repository. IMPORTANT: This action ONLY creates NEW references - if the reference already exists, it will fail with a 422 'Reference already exists' error. To update an existing reference, use the 'Update a reference' (GITHUB_UPDATE_A_REFERENCE) action instead. The repository must not be empty prior to this operation.
Generates a time-limited token required to register a new self-hosted runner with a specific repository.
Generates a temporary (one-hour) registration token to add a new self-hosted runner to an organization for GitHub Actions.
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 given, it must already exist.
Generates a temporary (one-hour validity) token required to unregister and remove a self-hosted runner from a repository.
Generates a token, valid for one hour, to authenticate removing a self-hosted runner from an organization.
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.
Triggers a GitHub Actions workflow or a webhook on a repository by creating a repository dispatch event, allowing programmatic triggering of workflows based on events outside of GitHub.
Creates a new repository for the authenticated user.
Publishes the specified codespace to a new repository, using the codespace's current state as the initial commit.
Creates a GitHub Projects V2 project owned by the repository owner and linked to the specified repository. A supplied project description is not applied during creation.
Creates a uniquely named ruleset for a repository, defining rules for branches or tags with specified enforcement, conditions, and bypass actors.
Creates a new repository from an existing template repository; the authenticated user must have access to the template and, if creating in an organization, repository creation permissions within it.
Creates a new, unencrypted variable in a repository for GitHub Actions workflows; fails if a variable with the same name already exists.
Creates a webhook for a specified repository; requires admin permissions on the repository.
Creates a review comment on a pull request diff at a specific line or range, using a diff position, or as a reply to an existing review comment.
Creates a pull request review, allowing approval, change requests, or comments; `body` is required if `event` is `REQUEST_CHANGES` or `COMMENT`, and omitting `event` makes the review `PENDING`.
Creates a repository-scoped and/or permission-scoped GitHub App user access token from a non-scoped user token. The endpoint requires Basic authentication with the app's client ID and client secret; repository scope may be specified by names or IDs.
Creates an annotated Git tag object in a repository, pointing to an existing commit, tree, or blob identified by its SHA and specified type.
Creates a new team in an organization, optionally with maintainers, repositories, specific privacy, notification settings, or a parent team; if `parent_team_id` is given, `privacy` must be 'closed'.
Creates a temporary private fork of the specified repository to address a security vulnerability, linking the fork to a GHSA ID that must be specifically associated with this repository; the fork may take up to 5 minutes to become accessible.
Creates a new Git tree object in a repository, defining file/directory structure by specifying tree entries, optionally building on a `base_tree` SHA; all provided SHAs must be valid.
Creates a GitHub Projects V2 project board for the authenticated user using the GraphQL API. An optional project description is accepted but not applied during creation.
Manually triggers a GitHub Actions workflow identified by `workflow_id` at a given `ref`, if the workflow is configured to accept `workflow_dispatch` events.
Creates a repository autolink to automatically convert text references (e.g., 'TICKET-123') into hyperlinks, using a unique `key_prefix` and a `url_template` that includes `<num>`.
Creates an encrypted environment variable for a pre-existing environment within a GitHub repository; will fail if the variable name already exists.
Creates a new issue in a GitHub repository, requiring the repository to exist and have issues enabled; specific fields like assignees, milestone, or labels may require push access.
Creates a new comment on an existing GitHub issue or pull request within the specified repository.
Creates a classic project board in a specified GitHub organization, with a name and optional description, for organizing project work. DEPRECATED: GitHub.com has disabled new classic project creation and sunset the classic REST API. Use GitHub Projects V2 instead.
Creates a new repository within a specified GitHub organization, with options for detailed configuration including visibility, features, merge strategies, initial commit, and templates.
Creates a new, uniquely named GitHub Actions variable for an organization, with configurable repository access visibility (all, private, or selected).
Creates a webhook for a GitHub organization to deliver event notifications to a configured URL.
Enables commit signature protection for a specified branch, requiring all new commits to be signed.
Creates a draft issue item in a user-owned GitHub ProjectsV2. Use when you need to add a new draft item to track ideas or tasks in a user's project.
Tool to create chat completions using GitHub Models inference API. Use when you need to generate AI-powered text responses using models like GPT-4, Claude, or Llama through GitHub's inference endpoint.
Tool to create inference embeddings using GitHub's AI models. Use when you need to convert text into vector representations for similarity search, clustering, or other ML tasks.
Create a new issue type for a GitHub organization. Requires the authenticated user to be an organization administrator. OAuth tokens need admin:org scope.
Generates a temporary Just-In-Time (JIT) configuration for a new self-hosted GitHub Actions runner for a repository; any specified non-default `runner_group_id` must be an existing runner group accessible by the repository.
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.
Creates or updates a GitHub Actions secret within a specific repository; use `encrypted_value` and `key_id` to set or change its value.
Creates or updates a Codespaces secret for the authenticated user, optionally restricting access to selected repositories. Accepts plaintext and encrypts it using the user's GitHub public key, or accepts a pre-encrypted value with its key ID.
Creates a new environment or updates an existing one in a GitHub repository, allowing configuration of deployment protection rules such as wait timers and reviewers; ensure `environment_name` is URL-encoded if it contains special characters.
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.
Creates or updates an organization secret for GitHub Actions, requiring its value to be pre-encrypted via LibSodium using the organization's public key.
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`.
Creates or updates a file in a GitHub repository with a commit message and supplied content. A missing non-default branch may result in the change being committed to the repository's default branch. Content may be supplied as plain text or Base64.
Enables or updates GitHub Pages configuration for a repository, including source, custom domain and HTTPS settings. The build type defaults to legacy, which requires a source branch even when updating an existing site.
Creates or updates a Dependabot organization secret, requiring the secret value to be pre-encrypted with LibSodium using the organization's public key obtained from the 'Get an organization public key' endpoint.
Creates or updates a Dependabot secret in a repository using an `encrypted_value` (pre-encrypted with LibSodium using the repository's Dependabot public key) and its corresponding `key_id`. This action allows you to securely manage secrets for a given repository, ensuring that sensitive data remains protected during the update process. By providing the encrypted value alongside the key ID, you can seamlessly maintain the necessary credentials for your repository's operations.
Creates or updates up to 30 custom property values for a repository; custom properties must be predefined at the organization or repository level, and setting a property's value to `null` removes it.
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.
Adds a specified reaction to a pull request review comment within a GitHub repository.
Creates an emoji reaction for a specific, existing release in a GitHub repository.
Creates a reaction for a team discussion within a GitHub organization.
Adds a reaction to a team discussion comment, requiring the specified organization, team, discussion, and comment to exist.
Creates a reaction for a specified issue within a GitHub repository.
Creates a reaction for a specific comment on an issue within a GitHub 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. The repository name must be unique for the user, and various settings can be configured such as visibility (public/private), enabled features (issues, wiki, projects), and merge options.
Create a GitHub Sponsors payment tier for a specified user or organization using GraphQL, with an amount and description.
Tool to start a new GitHub sponsorship or reactivate a past sponsorship using GraphQL. Use when you need to sponsor a maintainer through GitHub Sponsors with a specified amount and privacy level.
Tool to create a new user list on GitHub. Use when you need to organize and group GitHub users for easier tracking and management.
Tool to create a new view in a user-owned GitHub project (Projects V2). Use when you need to add a customized view with specific layout, filters, and visible fields to organize project items. Note: This action works with GitHub Projects V2. The view can be configured with different layouts (table, board, roadmap) and optional filters. The visible_fields parameter is not applicable to roadmap layouts.
Retrieves the OpenID Connect (OIDC) subject claim customization template for a repository's GitHub Actions workflows. The validated response has no declared template fields.
Declines a specific, pending repository invitation for the authenticated user, identified by its `invitation_id`.
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 given tool and reference to prevent data loss.
Deletes a specific codespace owned by the authenticated user; this is a destructive action and the codespace must exist.
Requests deletion of a specified organization member's codespace. A successful response may indicate that deletion was accepted and is still in progress; a not-modified response is also reported as successful.
Deletes a specific commit comment, identified by its `comment_id`, from the specified repository; the comment must exist.
Deletes a reaction from a commit comment in a GitHub repository.
Deletes a custom organization role (which should not be actively assigned) by its ID; a 204 No Content response indicates success.
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.
Permanently deletes a specified *inactive* deployment from a repository.
Deletes a specific deployment branch or tag policy, identified by its ID, from a given environment within a repository.
Deletes a specific team discussion, identified by its number, from an organization's team.
Deletes a specific comment from an existing team discussion within an organization, provided the specified organization, team, discussion, and comment all exist.
Deletes a file by path from a GitHub repository. The file's blob SHA is automatically fetched if not provided.
Permanently deletes an existing GitHub gist, specified by its `gist_id`; this action is destructive and cannot be undone.
Deletes a specific comment from a GitHub Gist using its `gist_id` and `comment_id`.
Deletes the GitHub Pages site for the specified repository; completes without error if no site is currently enabled.
Permanently removes an existing label from a repository.
Deletes the specified milestone if it exists; this operation is idempotent, typically returning a 404 if the milestone is not found or already deleted.
Deletes a package owned by the specified user, requiring admin permissions for the authenticated user; deletion of public packages with over 5,000 downloads may require GitHub support. A 404 or 422 is returned as an error message rather than raised.
Deletes a specific package in an organization; public packages with over 5,000 downloads cannot be deleted. Authentication, permission and not-found errors can be returned as response messages rather than raised.
Permanently deletes a specific package owned by the authenticated user; public packages downloaded over 5,000 times cannot be deleted via this API. A 404 is returned with success set to false rather than raised.
Deletes an existing package version associated with the authenticated user.
Deletes a pending (unsubmitted) review from a pull request; this is only possible if the review has not yet been submitted.
Deletes the specified GitHub project (Projects V2) using the GraphQL API. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects (classic) REST API was sunset on April 1, 2025 and is no longer available. The project is permanently deleted and cannot be recovered. The user must have admin permissions for the project to delete it.
Deletes a project field (column) from a GitHub Projects V2 project using the GraphQL API. IMPORTANT: GitHub Classic Projects REST API was sunset on April 1, 2025. This action now uses the GitHub Projects V2 GraphQL API with the deleteProjectV2Field mutation. Note: The built-in Status field cannot be deleted as it is a core field in GitHub Projects V2. Only custom fields can be deleted.
Deletes a specific reaction from a pull request review comment, provided the comment and reaction exist on that comment within the specified repository.
Deletes a Git reference from a repository. Branch names may be supplied without a prefix; they are treated as branch references.
Permanently deletes a specific release, its assets, and potentially its associated Git tag from a repository.
Deletes a specific release asset from a GitHub repository; this action is idempotent.
Deletes a reaction from a GitHub release, provided the repository, release, and reaction exist.
Permanently deletes the specified repository; this is a destructive, irreversible action that requires admin privileges for the repository.
Deletes a specified repository invitation.
Permanently deletes a repository ruleset.
Deletes a named GitHub Actions secret from a specified repository; this operation is destructive and idempotent, and requires the repository to exist.
Deletes the authenticated user's subscription to a specified repository if it exists, effectively 'unwatching' it.
Deletes a named variable (e.g., for GitHub Actions workflows) from a repository; the repository and the variable must already exist.
Deletes a specific webhook from a repository.
Deletes a specific pull request review comment.
Deletes an existing Codespaces secret for the authenticated user by `secret_name`. This is a destructive and irreversible operation. Returns 404 if the secret does not exist.
Removes a specific self-hosted runner (by `runner_id`) from a repository, if registered there; this is idempotent.
Removes a self-hosted runner from a GitHub organization, including when its machine no longer exists, immediately disconnecting it from GitHub Actions. Requires organization admin access and appropriate authorization; successful deletion returns a success message.
Deletes a team (and any child teams) from an organization.
Call this to mute a specific notification thread by deleting the user's subscription; notifications may still occur if the user is @mentioned, comments, or due to repository watch settings.
Deletes a specific workflow run from a repository.
Removes all user, team, and app-based access restrictions from a protected branch.
Removes admin enforcement from a protected branch (branch name cannot contain wildcard characters) in a repository.
Deletes a user's OAuth application grant, revoking the associated tokens for that application. Identify the grant with an access token issued by the app; GitHub requires the app's client ID and client secret for Basic Authentication.
Revokes a specified OAuth access token issued by an OAuth App or a GitHub App with OAuth authorization. GitHub requires Basic Authentication using the app's client ID and client secret for this operation.
Deletes a GitHub artifact by its ID within a repository, typically resulting in an empty response (HTTP 204 No Content) on success.
Deletes a specific autolink reference (which automatically links external resource IDs like JIRA-123 to URLs) from the specified repository.
Deletes an existing deployment environment from an existing repository.
Deletes an existing and accessible secret from a specified environment within a GitHub repository, returning an empty dictionary on success or error details otherwise.
Deletes a named environment variable from a specified, existing environment within a GitHub repository.
Permanently deletes a specific comment by its ID from an issue or pull request, if the repository exists and the comment ID is valid.
Deletes a reaction from an issue comment in a repository; the repository, comment, and reaction must exist.
Permanently removes a specific reaction from an issue in a GitHub repository.
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.
Permanently deletes a GitHub Actions secret from a GitHub organization, making it unavailable to workflows.
Deletes a named GitHub Actions variable from a specified organization.
Deletes a specific webhook, identified by `hook_id`, from an existing organization.
Attempts to delete specified email addresses from the authenticated user's GitHub account.
Removes all protection rules from a specific branch in a GitHub repository; the branch must currently have protection rules enabled.
Disables GPG commit signature protection for a specific branch in a GitHub repository, meaning commits pushed to this branch no longer require GPG signing.
Deletes a specific Dependabot secret, identified by its name, from a given repository if both the repository and secret exist.
Deletes a specific GitHub Actions cache from a repository using its unique `cache_id`.
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.
Deletes a specific version of a package owned by the specified user. The response indicates whether deletion succeeded; authentication, permission, and not-found errors are returned as unsuccessful results.
Deletes a specific package version within an organization; requires admin permissions for packages with over 5,000 downloads.
Tool to delete a project item for a user in GitHub Projects V2. Use when you need to remove an item from a user's project. Requires the project item's GraphQL node ID (starts with 'PVTI_'). Uses the GitHub GraphQL API deleteProjectV2Item mutation.
Disables the requirement for pull request reviews before merging for a specific, existing branch in an existing repository; this action is idempotent and will succeed even if the protection is not currently enabled.
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.
Deletes currently linked social media account URLs from the authenticated user's GitHub profile.
Deletes a reaction from a team discussion comment, given the organization name, team slug, discussion number, comment number, and reaction ID.
Permanently deletes a specific reaction from a team discussion within an organization.
Tool to delete a GitHub user list using GraphQL. Use when you need to remove a user list from a GitHub account.
Deletes all logs for a specific workflow run in a GitHub repository, provided the repository and run exist.
Disables a specific, currently active custom deployment protection rule for an existing environment within a GitHub repository.
Disables a specified workflow (by ID or filename) in a given GitHub repository, preventing new automatic triggers; any in-progress runs will continue.
Disables private vulnerability reporting for an existing GitHub repository, preventing direct private vulnerability reports to maintainers via GitHub's interface for this repository.
Removes a repository from the list of selected repositories enabled for GitHub Actions in an organization. Only works when the organization's `enabled_repositories` policy is set to `selected`. Requires admin:org scope.
Dismisses an APPROVED or CHANGES_REQUESTED review on a pull request with a mandatory explanatory message. IMPORTANT: Only reviews in APPROVED or CHANGES_REQUESTED state can be dismissed. Reviews in COMMENTED, PENDING, or already DISMISSED state will return a 422 error. To dismiss a review on a protected branch, you must be a repository admin or be authorized to dismiss pull request reviews.
Requests a ZIP archive of a repository at a specific Git reference (branch, tag, or commit SHA) and returns the redirect URL for downloading it. For private repositories, the URL expires after five minutes.
Gets a redirect URL for downloading a repository tarball at a specific Git reference. For private repositories, the URL expires after five minutes.
Downloads a GitHub Actions workflow artifact as a ZIP file. Returns the artifact as a downloadable file. Use GITHUB_LIST_ARTIFACTS_FOR_A_REPOSITORY or GITHUB_LIST_WORKFLOW_RUN_ARTIFACTS to get valid artifact IDs first.
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.
Downloads a ZIP archive of logs for a specific workflow run attempt. Returns a downloadable ZIP file containing logs for all jobs and steps in the workflow run.
Downloads logs for a specific GitHub Actions workflow run as a ZIP archive containing log files for each job in the workflow.
Reactivates a currently disabled GitHub Actions workflow within a repository using its workflow ID or filename.
Sets the specific repositories that can use GitHub Actions within an organization by replacing the current list; only applies if the organization's Actions policy is 'selected repositories'.
Enables private vulnerability reporting for a repository, allowing security researchers to privately submit vulnerability reports to maintainers.
Adds a repository to the list of selected repositories enabled for GitHub Actions in an organization. Requires the organization's 'enabled_repositories' policy to be set to 'selected'.
Creates or updates a repository's GitHub Codespaces secret. It accepts a plaintext value for automatic encryption or a value already encrypted with the repository's Codespaces public key.
Creates or updates an organization's GitHub Codespaces secret using an encrypted value and its corresponding public key ID.
Triggers an export of the authenticated user's specified codespace, automatically stopping it if active. Returns the export status and, when available, an export URL.
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.
Fetch a GitHub GraphQL node by its global ID. By default, only its ID is requested; supply a GraphQL fragment to retrieve additional fields.
Retrieves the public key for an existing GitHub organization, required for encrypting Dependabot secrets. Requires admin:org scope.
Searches pull requests by repository, author, state, labels, merge status, and other filters; without a repository or owner, it searches public repositories by default or PRs involving the authenticated user when requested. Search results are capped at approximately 1,000; creation and update date filters do not filter merge dates.
Search GitHub repositories by keywords, language, stars, topics, and ownership, returning paginated results. Repository qualifiers are reduced to owner filters, an owner with no public repositories can yield an immediate empty result, and OR expressions are limited to six terms; check incomplete_results for non-exhaustive results.
Allows the authenticated user to follow the GitHub user specified by `username`; this action is idempotent and the user cannot follow themselves.
Tool to follow a GitHub organization using GraphQL. Use when you need to make the authenticated user follow an organization.
Tool to follow a GitHub user using GraphQL. Use when you need to make the authenticated user follow another user.
Requests force cancellation of a queued or in-progress GitHub Actions workflow run, bypassing conditions such as always(), when standard cancellation fails. A successful response means the request was accepted for asynchronous processing; completed runs cannot be canceled, and repository write permissions are required.
Forks a specified public gist, creating a copy under the authenticated user's account.
Generates Markdown release notes content (listing changes, pull requests, and contributors) for a GitHub repository release, customizable via tags and a configuration file.
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.
Retrieves detailed information for a specified branch within a GitHub repository.
Retrieves detailed information for a specific check run within a GitHub repository.
Retrieves a specific check suite (a collection of check runs) by its ID from a repository accessible to the authenticated user.
Retrieves details for a specific GitHub Classroom. Requires the authenticated user to be an administrator of the classroom.
Retrieves the full details of a specific GitHub code of conduct using its unique key.
Retrieves a specific code scanning alert, which identifies potential code vulnerabilities or errors, by its number from the specified GitHub repository.
Retrieves detailed information for a specific code scanning analysis on an accessible repository, identified by its `analysis_id`.
Gets the default setup configuration for code scanning in a repository, including state, languages, query suite, and schedule for a repository if it exists.
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.
Call to retrieve detailed information for a `codespace_name` belonging to the authenticated user, ensuring the codespace exists and is accessible.
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.
Retrieves the full details of a specific commit comment in a GitHub repository, using its unique identifier.
Retrieves detailed information (including author, committer, message, tree, parents, verification) for a specific commit in a GitHub repository, identified by its SHA.
Retrieves a specific custom deployment protection rule (used by GitHub Apps for external validation or manual approval of deployments) for a given environment in a repository.
Retrieves the definition (schema) of a specific, existing custom property for an organization.
Retrieves a specific delivery for a repository webhook, identified by its `hook_id` and `delivery_id`.
Gets a specific deploy key, identified by its `key_id`, for the GitHub repository specified by `owner` and `repo`.
Gets a specific deployment by ID from a repository, provided the repository and deployment ID exist.
Retrieves a specific deployment branch policy for an environment in a repository, identified by its unique ID.
Retrieves a specific deployment status by its ID for a given deployment within a GitHub repository.
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.
Fetches a specific discussion by its number from a team within an organization. This is a read-only action that retrieves discussion details including title, body, author information, comment count, and reactions. The authenticated user must be a member of the organization to access team discussions.
Fetches a specific comment from a team discussion within a specific organization.
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.
Fetches a GitHub gist by ID, including its files and metadata. File contents or the file list may be truncated; use the raw file URL or clone the gist to retrieve complete content when needed.
Retrieves a specific GitHub Gist comment using the gist ID and comment ID, returning its text, author information, and timestamps.
Retrieves a specific revision of a gist.
Retrieves information for a GitHub Pages site, which must be enabled for the repository.
Retrieves a specific .gitignore template from GitHub by its name, which must be an existing template in GitHub's collection.
Retrieve a global GitHub security advisory by its GHSA identifier. Use this to get detailed information about vulnerabilities including severity, affected packages, CVSS scores, and references.
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.
Retrieves a specific label by its name from a specified GitHub repository.
Call this action to retrieve comprehensive details for a specific software license recognized by GitHub, using its unique license key.
Retrieves detailed information for a specific milestone within a GitHub repository by its number.
Retrieves metadata for a specific package owned by a GitHub user, using package type, name, and username as identifiers.
Retrieves a specific package (by type and name) from an organization, if both the package and organization exist.
Retrieves detailed information for a specific package owned by the authenticated user.
Retrieves a specific public package version associated with a GitHub user.
Retrieves detailed information for a specific version of a package within an organization.
Retrieves detailed information for a specific GitHub project (V2) using its project number and owner. Note: This action uses GitHub's Projects V2 REST API. The legacy Projects (classic) REST API was sunset on April 1, 2025. The project is identified by its number (visible in the project URL) and owner (either a username or organization name). If no owner is specified, the authenticated user is assumed.
Retrieves a specific pull request from a GitHub repository using its owner, repository name, and pull request number.
Retrieves a specific Git reference (e.g., a branch, tag, or fully qualified like 'heads/main') from a GitHub repository. The reference must exist in the repository; use 'list_matching_references' first if unsure what references are available.
Gets a specific release from a GitHub repository, provided the repository is accessible and the release exists.
Gets metadata for a specific release asset in a GitHub repository, including a `browser_download_url` for downloading the asset.
Gets a release from a GitHub repository by its tag name; the repository and a release with this tag must already exist.
Retrieves detailed information about an existing and accessible GitHub repository.
Gets a repository's public key for encrypting secrets to be used in GitHub Actions, if the repository exists and is accessible.
Fetches the README file (if it exists and is accessible) from a specified GitHub repository, returning its Base64-encoded content and metadata.
Retrieves the README file from a specified directory within a GitHub repository, optionally at a given commit, branch, or tag.
Gets detailed information for a specific repository rule suite by its ID, including its evaluation status and the results of its individual rules.
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.
Gets metadata (name, creation/update timestamps) for an existing repository secret, excluding its encrypted value.
Gets the authenticated user's subscription details for a repository, indicating if they receive notifications.
Gets a specific GitHub Actions variable by name from an accessible repository.
Returns the configuration of an existing webhook for a given repository.
Retrieves a specific pull request review comment by its ID, provided the repository exists, is accessible, and the comment ID is valid.
Retrieves a specific review for a pull request using its owner, repository, pull request number, and review ID.
Retrieves metadata (name, timestamps, visibility; not the value) for a specific, existing development environment secret associated with the authenticated user's GitHub Codespaces.
Gets a specific self-hosted runner for a repository by its unique ID.
Retrieves detailed information about a specific self-hosted runner registered within a GitHub organization.
Retrieves detailed information for a specific Git tag object from a GitHub repository, using the SHA of the tag object itself.
Retrieves a GitHub team by its slug from a specific organization.
Retrieves a specific GitHub notification thread using its unique `thread_id`.
Retrieves the authenticated user's subscription details for a specific notification thread, identified by `thread_id`.
Retrieves the public profile information for an existing GitHub user, specified by their username.
Returns the configuration for an existing webhook on the specified repository.
Retrieves the configuration for a specific webhook associated with a GitHub organization.
Returns detailed information for a specific delivery attempt of a webhook configured for the specified GitHub organization.
Retrieves detailed information for a specific GitHub Actions workflow in a repository, identified by either its numeric ID or its filename.
Gets a specific workflow run by its ID from a GitHub repository.
Retrieves detailed information for a specific attempt of a workflow run in a GitHub repository, including its status, conclusion, and timings.
Retrieves user, team, and GitHub App push restrictions for a protected branch. A 404 is returned as a message indicating that restrictions were not found; it can also mean the branch does not exist or is not protected.
Checks if repository administrators are subject to the branch protection rules on a specific branch.
Retrieves all officially supported, date-based (e.g., "2022-11-28") versions of the GitHub REST API from the /versions endpoint.
Retrieves all autolinks (e.g., for JIRA issues) configured for a repository; requires admin permissions on the repository.
Retrieves all available codes of conduct from GitHub, often used to select one for a repository.
Retrieves a list of commonly used software licenses from GitHub, optionally filtering for 'featured' licenses whose specific selection criteria by GitHub may vary.
Retrieves commit activity (total commits, weekly additions/deletions/commits) for all contributors to a repository; may require a retry if GitHub returns 202 while preparing data.
Gets the schema definitions for an organization's custom properties, rather than repository-specific values. On non-200 responses, it returns an empty property list alongside an error and status code.
Gets all custom property values for a repository. Custom properties are defined at the organization level, so this endpoint works with organization-owned repositories. Returns an empty array if no custom properties are set.
Lists all enabled custom deployment protection rules for a specific environment in a repository; the environment must exist and be configured for deployments.
Retrieves all available .gitignore template names from GitHub (e.g., 'Python', 'Node', 'Java'), used for generating .gitignore files.
Lists all custom organization roles for an existing GitHub organization.
Retrieves a page of rulesets for a GitHub repository, including parent rulesets by default. Rulesets define conditions and actions for repository interactions such as branch protection.
Retrieves all topics for a specified, existing, and accessible repository.
Gets all users and teams requested to review a specific pull request in a repository.
Fetches required status check contexts for a branch. Returns an empty list for 404 responses other than an explicit branch-not-found message, so an empty result does not necessarily establish that checks are absent.
Gets the settings for allowed actions and reusable workflows in a repository. Requires the repository's `allowed_actions` policy to be set to `selected` (returns 409 if set to `all` or `local_only`).
Gets the list of allowed actions and reusable workflows for an organization when the 'allowed_actions' policy is set to 'selected'.
Retrieves publicly available information for an existing GitHub App, identified by its unique URL-friendly `app_slug`.
Gets a specific artifact for a repository by `artifact_id`. This action retrieves the details of a specific artifact from a GitHub repository using the artifact's unique identifier. It allows users to access information about artifacts stored in the repository.
Retrieves detailed information for a specific GitHub Classroom assignment if the authenticated user is an administrator of the classroom.
Retrieves a specific autolink reference (which automatically hyperlinks text like 'JIRA-123' to an external system) for a repository using its unique ID; requires administrator access to the repository.
Retrieves the details of a specific deployment environment for a given repository, including its name, configurations, and current status.
Retrieves the public key for a specified GitHub repository environment, used to encrypt secrets for GitHub Actions.
Retrieves metadata (name and timestamps) for a single secret in a GitHub Actions environment. Note: The actual secret value is never returned by this API for security reasons.
Retrieves a specific environment variable from a GitHub Actions environment by repository owner, repository name, environment name, and variable name.
Retrieves detailed information about a specific issue in a repository using the owner, repository name, and issue number.
Action to get an issue comment.
Fetches details of a specific issue event for a given repository and event ID.
Get an organization
Retrieves a GitHub organization's Actions secrets public key for encrypting organization secrets.
Retrieves a specific GitHub organization role by its ID.
Gets an organization secret's metadata (e.g., name, creation/update dates, visibility), but not its encrypted value.
Retrieves details (name, value, visibility, timestamps) of a specific, existing variable for an existing GitHub organization.
Retrieves the full configuration, including subscribed events and delivery settings, for an existing organization webhook.
Lists GitHub Apps with push access to a repository's protected branch. A 404 returns no app list and an explanatory message; it can indicate a missing branch or unavailable restrictions.
Retrieves all grades for an existing GitHub Classroom assignment.
Retrieve the connected user's membership in one GitHub organization.
Retrieves detailed information for an existing specific package version associated with the authenticated user, identified by its type, name, and version ID.
Tool to get billing premium request usage report for a GitHub user. Use when you need to retrieve usage data for premium features like Copilot or AI models.
Retrieves the billing usage report for a specified GitHub user. Use when you need to analyze billing costs and usage patterns.
Tool to retrieve billing usage summary for a GitHub user account. Use when tracking usage costs, monitoring billing details, or generating usage reports for a specific user. Note: This endpoint only returns data for the past 24 months and is currently in public preview.
Retrieves branch protection settings for a specific accessible branch in a GitHub repository, such as required status checks, review requirements, and push restrictions. Availability varies by GitHub product plan; fine-grained tokens require repository Administration read permission. The branch name cannot contain wildcards.
Tool to retrieve the list of AI models available in the GitHub Models catalog. Use when you need to discover available models, their capabilities, token limits, and supported modalities.
Tool to look up a code of conduct by its key using GitHub's GraphQL API. Use when you need to fetch code of conduct details as part of a GraphQL workflow.
Fetches commit authors identified during a repository import, used to map authors from an external VCS to GitHub accounts. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports.
Gets the commit signature protection status for a branch in a repository.
Lists a page of statuses for a commit reference (SHA, branch, or tag) in reverse chronological order, for checking CI/CD results from various systems.
Retrieves a repository's community profile metrics, including health percentage and the presence of key community files (e.g., README, LICENSE).
Gets contextual hovercard information for a GitHub user; `subject_type` and `subject_id` can be jointly provided for more specific details.
Retrieves the OpenID Connect (OIDC) subject claim customization template for a GitHub organization, which defines how the `sub` claim in OIDC tokens for workflows is constructed.
Get pre-flight data (e.g., default location, devcontainer path) for creating a Codespace in a given repository (must exist and be accessible), optionally for a specific Git ref.
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.
Gets the default GITHUB_TOKEN workflow permissions and settings for a GitHub organization.
Get one Dependabot vulnerability alert for a repository.
Retrieves detailed information about a specific export of a codespace.
Lists all emojis available for use on GitHub, including custom and Unicode emojis.
Tool to look up a pending enterprise unaffiliated member invitation by invitee and enterprise. Use when you need to check the status of a specific invitation.
Fetches a list of available GitHub feed URLs for the authenticated user.
Retrieves the total count of active GitHub Actions caches and their combined size in bytes for a specified repository.
Retrieves total GitHub Actions cache usage for an organization, including active cache count and size across its repositories. Usage data refreshes approximately every five minutes and may lag changes.
Gets the GitHub Actions permissions policy for a repository, including its enabled status and the scope of allowed actions.
Gets the GitHub Actions permissions for a specified organization, detailing repository enablement and allowed actions policies.
Retrieves a map of all top-level GitHub REST API resource URLs and their templates.
Fetches GitHub's publicly available metadata, useful for configuring network security policies or IP allow-listing.
Retrieves detailed information about a specific GitHub Pages build for a repository, which must have GitHub Pages enabled.
Tool to retrieve the authenticated client's GitHub GraphQL API rate limit information. Use when you need to check remaining quota, current usage, or reset time for GraphQL requests.
Retrieves detailed information, including processing status and results URL, about a specific SARIF (Static Analysis Results Interchange Format) upload for a repository, uniquely identified by its sarif_id.
Retrieves active interaction restrictions for a repository, detailing which user groups are limited from activities like commenting or creating pull requests, and when these restrictions expire.
Retrieves interaction restrictions for an organization, showing which GitHub user types can interact with its public repositories and when restrictions expire; returns an empty response if no restrictions are set.
Retrieves currently active interaction restrictions for the authenticated user's public repositories.
Retrieves a page of comments for a specific GitHub issue. Comments can be filtered by update time and paginated to view discussion history.
Lists files larger than 100MB identified during a previous source import for the specified repository. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports.
Retrieves information about the most recent GitHub Pages build for a repository, which must exist, be accessible, have GitHub Pages enabled, and have at least one prior build.
Tool to look up an open source license by its SPDX ID using GitHub's GraphQL API. Use when you need to fetch license details for compliance tracking or repository setup.
Fetches an ASCII art representation of GitHub's Octocat, suitable for text-based displays.
Retrieves metadata for a specific secret available to an organization's GitHub Codespaces without exposing its encrypted value.
Tool to retrieve an organization's audit log events for security and compliance investigations. Use when tracking organizational changes, security audits, or compliance monitoring. Requires organization owner permissions and read:audit_log scope.
Gets a single organization Dependabot secret's metadata (name, timestamps, visibility) without revealing its encrypted value. Requires admin:org scope.
Return a named user's membership state and role in a GitHub organization.
Tool to get an item from an organization-owned GitHub Projects V2 project. Use when you need to retrieve details about a specific project item including its content, fields, timestamps, and creator information.
Retrieves an organization's public key, which must be used to encrypt secret values before they are configured for Codespaces.
Retrieves a list of teams for a specified GitHub organization. Use this action when you need to list all teams, find team information, or explore team structure within an organization. Requires read:org scope and returns paginated results.
Retrieves page view statistics for a repository over the last 14 days, including total views, unique visitors, and a daily or weekly breakdown.
Retrieve the parent issue of a GitHub sub-issue.
Retrieves pending deployment environments for a specific workflow run that are awaiting approval due to protection rules.
Retrieves permission information for a GitHub project (classic) collaborator. Returns the permission level and may include the collaborator's GitHub user information.
Retrieves a repository's public key for encrypting GitHub Codespaces secrets. For private repositories, classic OAuth or personal access tokens need the repo scope; fine-grained tokens need write permission for repository Codespaces secrets.
Retrieves the authenticated user's public key for encrypting GitHub Codespaces secrets. The returned key must be used with libsodium sealed box encryption before creating or updating secrets via the API.
Retrieves the pull request review protection settings for a specific branch in a GitHub repository, if such protection is configured.
Retrieves a page of pull requests from a repository, optionally filtered by state, base branch, or head branch and sorted by the selected order. Returns pull request details including title, state, author, labels, timestamps, and branch information.
Retrieves the authenticated user's current GitHub API rate limit status, including usage and limits across different resource categories.
Fetches raw file content from a GitHub repository as a downloadable file, without parsing or validating its format. Ensure owner, repo, ref, and path are consistent when combining with other GitHub tools.
Tool to retrieve attestations by subject digest from a GitHub repository. Use when you need to verify or check attestations for a specific artifact identified by its SHA256 digest.
Retrieves the total number of clones and a breakdown of clone activity (daily or weekly) for a specified repository over the preceding 14 days.
Retrieves a file's Base64-encoded content or lists a directory's contents in a GitHub repository. Specify a branch, tag, or commit to read from, or use the repository's default branch; an empty path lists the root directory.
Gets metadata (name, creation/update timestamps) for a specific, existing development environment secret (Codespaces secret) in a repository, without exposing its value.
Reads one repository Discussion with cursor-paginated top-level comments and up to the requested first replies for each comment.
Tool to lookup a repository owner (User or Organization) by login using GitHub's GraphQL API. Use when you need to determine whether a login is a user or organization and retrieve basic profile information.
Retrieves a user's repository permission and assigned role, including custom roles. The legacy permission level is admin, write, read, or none; maintain maps to write and triage to read.
Retrieves metadata for an existing Dependabot secret in a repository, without exposing its encrypted value.
Tool to retrieve a repository security advisory using its GHSA identifier. Use when you need detailed information about a specific security vulnerability.
Gets one page of up to 30 privacy-safe weekly star-count records, newest first. Increase `page` to move backward in a repository's history.
Tool to lookup a repository by owner and name using GitHub's GraphQL API. Use when you need comprehensive repository information.
Retrieves a page of active rules for a specific branch in a GitHub repository, excluding rules in 'evaluate' or 'disabled' status.
Retrieves the status check protection settings for a specific branch in a GitHub repository, if status check protection is enabled for it.
Retrieves one page of members for a specific team within an organization, including members of child teams, optionally filtered by role. Requires the authenticated user to have read access to the team.
Retrieves a user's role and membership status in a GitHub organization team. A successful lookup returns the role and state; is_member=False can also indicate access denial or a missing team or organization, not just non-membership.
Lists teams with explicit push access to a protected branch. A 404 response is returned as an empty teams list, which can also reflect a missing branch or absent branch protection.
Gets the profile information for the currently authenticated GitHub user, including potentially private details based on user settings.
Retrieves the combined commit status and status entries for a specific reference (SHA, branch, or tag) in a GitHub repository.
Retrieves the 'punch card' data, showing hourly commit counts for each day of the week for an existing and accessible repository.
Fetches weekly commit totals and daily commit counts for the last 52 weeks for a specified GitHub repository.
Fetches the latest official (non-prerelease, non-draft) release for a GitHub repository; requires at least one such published release.
Retrieves the license file and its details for a repository, optionally from a specific Git reference (branch, tag, or commit SHA).
Retrieves the detailed approval history for a specific workflow run in a GitHub repository, detailing each review's environment, state, reviewer, and comments, to track the approval process for workflows, particularly automated deployments.
Retrieves the status of a specific GitHub Pages deployment for a repository, which must have GitHub Pages enabled.
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.
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 202 status or an empty response if statistics are being computed.
Retrieves a random quote from GitHub's 'Zen of GitHub' collection, reflecting GitHub's design philosophies and offering humorous insights, useful for displaying GitHub wisdom or a lighthearted message.
Fetches the top 10 most viewed content paths for a repository from the last 14 days.
Fetches the top 10 websites that referred traffic to a repository within the last 14 days.
Retrieves attestations for a GitHub user and subject digest, with optional predicate filtering and pagination. A GitHub 404 is returned as an empty attestation list.
Retrieves a GitHub user's profile information by their unique numeric account ID. Use when you know the user's numeric ID rather than their username.
Tool to get an item from a user-owned project in GitHub Projects V2. Use when you need to retrieve details about a specific item (issue, pull request, or draft issue) in a user's project board.
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.
Lists users with explicit push access to a protected branch through its push restrictions. A 404 response is returned as an empty user list, including when the branch or repository is inaccessible or missing.
Tool to retrieve the authenticated user's profile information via GitHub GraphQL. Use when working with GraphQL queries or need viewer details in GraphQL format.
Gets the access level settings for a private repository, determining how workflows outside this repository can use its actions and reusable workflows.
Gets the billable time, in milliseconds, for a specific workflow run, detailing time spent on various operating systems.
Gets the billable time (in milliseconds, broken down by runner OS) for a specific workflow within a repository for the current billing cycle.
Tool to perform GitHub GraphQL searches across issues, pull requests, repositories, users, and discussions. Returns up to 1,000 results with cursor-based pagination. Use when you need structured search results with specific fields.
Lists accepted assignments (student repositories created after acceptance) for an existing GitHub Classroom assignment, identified by its unique `assignment_id`.
Lists a page of GitHub App installations accessible to the authenticated user, including installation details, permissions, and repository access. Supports page and page-size selection and returns the total count of accessible installations.
Lists GitHub Actions workflow artifacts for a specified repository, which must exist.
Lists users who can be assigned to issues in a repository, typically those with push access.
Lists a page of assignments for an accessible GitHub Classroom, with page and page-size controls.
Tool to list attestation repositories for an organization. Use when you need to discover which repositories in an organization have attestations. Attestations provide verifiable metadata about software artifacts.
List public Git SSH keys owned by the connected GitHub user.
Lists a page of pending repository invitations for the authenticated user.
Lists machine types available for GitHub Codespaces in a repository, optionally using a Git ref to check compatibility based on prebuild availability and devcontainer configurations.
Lists a page of branches in a GitHub repository, optionally filtered by protection status. Returns branch names, commit information, and protection status.
Lists branches in an accessible repository where the provided commit SHA is the head, useful for identifying development lines based on that commit.
Lists annotations for a specific check run in a GitHub repository, detailing issues like errors or warnings on particular code lines.
List GitHub check runs for a commit SHA, branch, or tag to assess CI status and conclusions. Results default to the latest runs; the filter can be set to include all runs.
Lists check runs for a specific check suite in a GitHub repository, optionally filtering by check name or status. Results default to the latest runs; the filter can be set to include all runs.
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.
Lists the immediate child teams of a parent team within an organization.
Lists GitHub Classrooms to which the authenticated user has administrative access.
Lists code scanning alerts for a repository, optionally filtering by tool, Git reference, state, or severity. Some scanning or authorization errors return an empty alert list with a message rather than an error.
Lists code scanning alerts for a GitHub organization; use either tool name or tool GUID when filtering by tool. Some access or scanning errors return an empty alert list with a message.
Lists code scanning analyses for a repository, optionally filtering by tool, Git reference, or SARIF ID. Some scanning and access errors return an empty list without an explanatory message.
Lists syntax errors in a repository's CODEOWNERS file, which must be located at the root, `.github/`, or `docs/` directory for the specified ref.
Lists all CodeQL databases for a repository where CodeQL analysis has been previously run and completed.
Tool to fetch all available codes of conduct using GitHub's GraphQL API. Use when you need to retrieve the complete list of codes of conduct that can be applied to repositories.
Lists a page of GitHub Codespaces for a specified member of an organization, with pagination controls.
Lists GitHub Codespaces for the authenticated user, optionally filtering by repository ID and supporting pagination.
Lists active/pending GitHub Codespaces for an existing organization; admins list all, members list their own.
Tool to list issue and PR comment changes across an organization's repositories efficiently. Use when monitoring comment activity without per-PR/per-issue polling. Filters organization events to return only comment-related events (IssueCommentEvent, PullRequestReviewCommentEvent, CommitCommentEvent). Note: Events are limited to the past 30 days and up to 300 events per timeline. Use ETag header for efficient polling to avoid rate limits.
Lists a page of comments for a specific review on a GitHub pull request, with pagination support.
Retrieves a page of comments for a specific commit in a GitHub repository, supporting pagination.
Lists a page of commit comments for an accessible GitHub repository.
Lists a page of commits for a GitHub repository, optionally filtered by SHA or branch, path, author, committer, or date range. The default page size is one commit.
Lists commits for a pull request; requires the repository and pull request to exist and be accessible, and supports pagination.
Lists repositories in an organization with their custom property values. Requires 'Custom properties' organization permission (read).
Retrieves delivery attempts for a specific repository webhook to inspect its history; ensure the webhook ID exists.
Retrieves a list of webhook deliveries for a specific webhook in an organization, allowing inspection of delivery history and details.
Lists deploy SSH keys for a specified repository; the repository must exist.
Lists a page of deployment branch policies for a specified environment in a GitHub repository.
Lists a page of statuses for a given deployment in a repository.
Lists deployments for a specified repository; repository must exist.
Lists a page of comments for a specific team discussion within an organization; team discussions are deprecated. A 404 response is returned as an empty list, so an empty result does not necessarily mean there are no comments.
Lists a page of discussions for a specific team within an organization, with sorting and pinned-status filtering; team discussions are deprecated. A 404 response is returned as an empty list, so an empty result does not necessarily mean there are no discussions.
List Docker packages with migration conflicts for the authenticated user. This endpoint lists all Docker packages owned by the authenticated user that encountered namespace conflicts during the Docker-to-GitHub Container Registry (GHCR) migration. Conflicts occur when a package with the same name exists in both the legacy Docker registry and GHCR. IMPORTANT: The Docker registry for GitHub Packages was deprecated on Feb 24, 2025. This endpoint may return a 400 error with message 'Package migration for docker is no longer supported' as the migration period has ended. In this case, the action returns an informative response instead of failing. Use case: Identifying packages that require manual migration to GHCR. Required scope: read:packages (for OAuth and personal access tokens).
Lists a page of email addresses for the authenticated user, including their primary status, verification status, and visibility.
Lists a page of custom deployment protection rule integrations available for a GitHub repository environment. The caller must have repository admin or owner permissions; pagination supports up to 100 results per page.
Lists the names and metadata (not values) of secrets for a specified, existing environment within an existing GitHub repository.
Lists a page of plaintext GitHub Actions environment variables for a specified environment within a repository.
Retrieves a page of deployment environments for a specified repository, which are used to configure protection rules and secrets for different software lifecycle stages.
Lists public events for the specified GitHub user, or private events if authenticated as that user, in reverse chronological order.
Lists events performed by a GitHub user in reverse chronological order. If authenticated as the specified user, you will see private events; otherwise, only public events are returned. Use this action when you need to retrieve a user's activity history, such as commits, pull requests, issues, and other GitHub actions.
Lists events a specific GitHub user received from followed users and watched repositories; returns private events if authenticated for `username`, otherwise public.
Lists followers for a specified, existing GitHub user.
Lists users following the authenticated GitHub user, returning an empty list if the user has no followers.
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. The response includes public profile information for each followed user with pagination support.
Lists forks for a specified repository, which must exist, with options for sorting and pagination.
Lists comments for a specified GitHub Gist.
Lists a page of commits for a specified gist, with pagination controls.
Lists a page of forks for a given GitHub gist ID, with pagination controls.
_lists public gists for a specified GitHub user._
Lists gists for the authenticated user, with optional filtering by update time and pagination.
Lists GitHub Actions caches for a repository, with options to filter by Git reference or cache key, and to sort and paginate results.
Lists GitHub Pages builds for a repository; GitHub Pages must be enabled on the repository for builds to be listed.
Lists GitHub's global security advisories, filterable by ID, type, ecosystem, severity, dates, and other attributes. The advisory type defaults to reviewed.
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.
Lists pending installation requests made by users or organizations for the authenticated GitHub App.
Lists a page of instances of a specific code scanning alert, optionally filtered by Git ref. Some access or repository-state errors are returned as an empty instance list with an explanatory message.
Lists comments for a specified issue in a GitHub repository.
Lists issue comments, including those on pull requests, for an accessible repository.
Lists a page of issues that block a specified GitHub issue.
Tool to list dependencies an issue is blocking. Use when you need to see which issues are blocked by a specific issue.
Retrieves a page of issue events for a specific issue within a GitHub repository.
Lists a page of issue events, such as closed, reopened, and assigned events, for a specified repository.
List all issue types configured for a GitHub organization. Requires read:org scope for OAuth tokens.
Lists GitHub issues for the authenticated user across visible repositories, with filtering by user relationship, state, labels, an ISO 8601 `since` timestamp (YYYY-MM-DDTHH:MM:SSZ), and sorting options; pull requests are typically included.
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. Supports pagination and field filtering.
Lists jobs for a specific workflow run in a GitHub repository.
Lists jobs, including details like ID, status, and steps, for a specific attempt of a GitHub Actions workflow run.
Lists labels for a specified GitHub repository, with pagination.
Lists all labels assigned to a specific self-hosted runner registered with the given repository.
Lists all labels assigned to a specific self-hosted runner within a GitHub organization, which are used to route workflows.
Lists a page of labels for a specified issue in a GitHub repository, with pagination controls.
Lists a page of labels for issues within a specific milestone in a repository.
Tool to fetch all known open source licenses using GitHub's GraphQL API. Use when you need to retrieve the complete list of licenses that can be applied to repositories.
Lists available machine types for a specific, accessible codespace, enabling it to be transitioned to a new hardware configuration.
Tool to list GitHub Marketplace subscriptions for the authenticated user. Use when you need to retrieve active marketplace app subscriptions including billing details, plan information, and trial status. Returns subscription information with account, plan, billing cycle, and pricing details.
Lists a page of Git references, such as branches or tags, in a repository that start with the provided partial reference path.
Lists milestones, which track progress for groups of issues and pull requests, for an existing repository, allowing filtering by state and sorting.
Tool to list notification threads for the authenticated user with efficient polling support. Use when you need to fetch the user's GitHub notification inbox with filters like unread/participating/since. Returns notification threads plus polling headers (Last-Modified, ETag, X-Poll-Interval) for efficient polling. IMPORTANT: This endpoint requires a Personal Access Token (classic) with 'notifications' or 'repo' scope. It does NOT work with GitHub App tokens or fine-grained personal access tokens. If the token type is incompatible, a clear error message will be returned.
Lists all Codespaces secrets available for a specified organization, which must exist.
Lists approved fine-grained personal access tokens with access to a GitHub organization's resources, with optional filters; requires a GitHub App with read access to the organization's personal access tokens. Non-list API responses are returned as an empty token list.
Lists requests from organization members to access organization resources with fine-grained personal access tokens (pending, approved, or denied). Note: This endpoint requires GitHub App authentication with 'organization_personal_access_token_requests:read' permissions; it cannot be used with personal access tokens.
List GitHub App installations across a named organization.
Lists a page of Dependabot secret metadata for a specified organization, including names and creation and update timestamps, without secret values.
Lists public events for the authenticated user's organization dashboard in a specified GitHub organization, such as pushes, pull requests, issues, and forks. The user must be an organization member to see events. Results are paginated; a 404 response is reported as an empty event list.
Lists all fine-grained permissions available in a GitHub organization for use in custom organization roles. These permissions define granular access controls that can be combined when creating custom roles. Note: This endpoint requires GitHub Enterprise Cloud with the custom organization roles feature enabled. The authenticated user must be an administrator or have the 'read_organization_custom_org_role' permission.
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 a page of members of a GitHub organization, optionally filtered by role or two-factor authentication status. Organization owners can filter by 2FA status to identify members who need to enable or upgrade their 2FA methods.
List organization memberships for authenticated user
Lists a page of items in a specific view of a GitHub organization's Projects V2 project, with their content, metadata, and field values. Returns pagination cursors when available.
Lists projects (V2) for a specified GitHub organization, with optional search query and cursor-based pagination.
Retrieves a list of repositories for a specified GitHub organization, allowing filtering by type and sorting.
Lists the selected repositories that are enabled for GitHub Actions in an organization. This endpoint only returns results when the organization's 'enabled_repositories' permission policy is configured to 'selected'. Requires admin:org scope and organization admin permissions.
Lists GitHub Actions secrets available for a specified organization.
Lists a page of GitHub Actions variables for a specified organization.
Lists a page of webhooks for a specified GitHub organization, with pagination controls.
Lists GitHub organizations for the authenticated user, sorted by ID in ascending order.
Lists public organizations for a specified GitHub user; the `username` must be a valid GitHub handle.
List a page of public organization memberships for a specified GitHub user, with pagination controls.
Lists organizations the authenticated GitHub user is a member of, returning details for each organization.
Lists outside collaborators for a GitHub organization, with options to filter (e.g., by 2FA status) and paginate results.
Lists a page of versions for an existing package owned by the authenticated user, identified by its type and name. Results can be filtered by active or deleted state.
Lists a page of versions of a public package owned by a specified GitHub user, identified by package type, package name, and username.
Lists a page of versions for a specified package owned by a GitHub organization, filtered by active or deleted state. Defaults to active versions.
Lists packages for a specified GitHub user, filterable by package type and visibility.
Lists GitHub Packages for an organization, noting specific interpretations for package_type and visibility parameters.
Lists packages of a specific type and visibility within the authenticated user's namespace on GitHub.
Lists a page of pending membership invitations for a specified team within an organization, including invitee, role, and inviter details; total_count is the number returned on that page. The authenticated user must be an organization member with read:org scope.
Lists people the authenticated user follows.
Lists collaborators for a GitHub Project (classic) by project ID. IMPORTANT: This action uses the Projects (classic) REST API which was sunset on April 1, 2025 for GitHub.com. The API may still be available on GitHub Enterprise Server versions before 3.17. For GitHub.com users: GitHub Projects (classic) has been replaced by the new Projects experience. The new Projects does not have a REST API for listing collaborators - use the GitHub web interface to manage project collaborators instead. You must be an organization owner or a project admin to list collaborators.
Lists a page of columns in a GitHub Projects (classic) project, such as its stages of work. A missing or unavailable project can produce an empty list. DEPRECATED: The Projects (classic) REST API has been sunset; use the newer GitHub Projects instead. Projects (classic) was removed from GitHub Enterprise Server 3.17.
Tool to list all fields in a GitHub Projects V2 project for a specific user. Use when you need to see available fields in a project.
Lists a page of items, including issues, pull requests and draft issues, in a user-owned GitHub project. Supports cursor pagination and filtering.
Lists the public email addresses for the authenticated user.
Lists public GitHub events, which may be delayed by up to 5 minutes, with support for pagination.
Retrieves public events (up to 90 days old, newest first) for a GitHub repository network, including the repository and its forks.
Retrieves a list of public events for a specified GitHub user, in reverse chronological order.
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 public, and if blocked by the authenticated user, a 404 error is returned.
Lists public gists from GitHub, optionally filtering by a 'since' timestamp and supporting pagination; results are generally newest first.
Lists the verified public SSH keys for a specified GitHub user.
Lists public events for a specified GitHub organization, which must exist. This action retrieves the events that are publicly accessible for the organization specified. It returns a paginated list of events with details about each event.
Lists users who have publicly declared their membership in a specified, existing GitHub organization.
Lists all public repositories on GitHub; use the `since` parameter with a repository ID from a previous result for pagination.
Lists pull requests for a GitHub repository. REQUIRES 'owner' AND 'repo' parameters - both are MANDATORY and must be provided in every call. Does NOT support filtering by assignee or date range - use GITHUB_FIND_PULL_REQUESTS instead for searching PRs by assignee, author, or across multiple repositories.
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.
Lists a page of files changed in a specified GitHub pull request, including additions, modifications, and removals.
Lists reactions for a specific commit comment; this is a read-only operation.
Lists reactions for a pull request review comment in a repository, optionally filtering by reaction type.
Lists a page of reactions for a GitHub release, optionally filtered by reaction type.
Lists a page of reactions for an existing team discussion within an organization, optionally filtered by reaction type. OAuth app tokens and personal access tokens (classic) need the `read:discussion` scope.
Lists reactions for a specific comment in a team discussion within an organization, optionally filtering by content type.
Lists reactions for a specific, existing issue within an accessible GitHub repository, optionally filtering by content type.
Lists reactions for a specific issue comment in a GitHub repository, optionally filtering by content type.
Lists assets (e.g., compiled binaries, source code archives) for a specific GitHub release, identified by `release_id` which must be valid for an existing release in the repository.
Retrieves a page of releases for a specified repository, including published releases and available draft and prerelease versions.
Lists repositories in an organization that a fine-grained personal access token has requested access to. Only GitHub Apps can use this endpoint. Requires 'Personal access token requests' organization permissions (read).
Lists Codespaces the authenticated user can access within a specified, existing repository.
Lists the `devcontainer.json` configurations available in a specified repository for use with GitHub Codespaces.
Lists a page of Codespaces secrets for a specified repository, without their encrypted values. Returns secret metadata and the total count.
Lists repositories a GitHub App installation can access. IMPORTANT: This endpoint requires a GitHub App installation access token (ghs_* prefix) for authentication. OAuth/user access tokens (gho_*) or personal access tokens are not supported and will result in a 403 Forbidden error. Returns 'total_count' and 'repositories' array with pagination support.
Retrieves a paginated list of GitHub Actions cache usage statistics for repositories within an existing GitHub organization.
Lists repositories accessible to the authenticated user based on visibility, affiliation, and type filters. Returns repositories owned by the user, those they collaborate on, or those accessible through organization membership. Use this action when you need to retrieve a comprehensive list of repositories the authenticated user can access, with options to filter by visibility (public/private), affiliation (owner/collaborator/organization), or type. Supports pagination for large result sets.
Lists repositories that the authenticated user can access through a specific GitHub App installation. Returns repositories where the user has explicit :read, :write, or :admin permission through the installation. The response includes permission details for each repository. Prerequisites: - Requires a GitHub App user access token (not a standard OAuth token) - Use GITHUB_LIST_APP_INSTALLATIONS first to get valid installation IDs
Lists public repositories for a specified GitHub user, who must have an existing account.
Lists repositories for the authenticated user; using 'type' with 'visibility' or 'affiliation' API parameters (not in this model) can cause a 422 error.
Lists repositories a valid and existing GitHub user has starred.
Lists repositories starred by the authenticated user, with sorting and pagination options.
Lists repositories a given GitHub user is watching; the username must be a valid and existing GitHub user handle.
Lists repositories the authenticated user is watching (subscribed to for notifications). This action retrieves a list of repositories that the authenticated user is currently watching. It allows the user to manage their watched repositories effectively.
Lists activities for a GitHub repository, ensuring the repository exists and is accessible.
Lists collaborators for a specified repository, provided it exists and is accessible to the authenticated user.
Lists contributors to a specified repository, sorted by number of contributions in descending order; the repository must exist and be accessible.
List Dependabot vulnerability alerts for a repository with filters and cursor pagination.
Lists chronological events (e.g., code pushes, issue activities, PR actions, forks) for a specified, existing GitHub repository.
Browse a GitHub repository's tree at a specified branch, tag, commit or tree SHA. Recursive mode lists nested entries in one request, but results can be truncated; check the returned truncation flag.
Lists a page of pending collaboration invitations for a specified GitHub repository.
Lists issues (including pull requests) from a GitHub repository. Requires BOTH 'owner' AND 'repo' parameters (e.g., owner='octocat', repo='Hello-World' for github.com/octocat/Hello-World).
Lists the programming languages used in a GitHub repository, returning a byte count for each language.
Retrieves notifications for the authenticated user from a specified repository, to which the user must have access.
Lists names of organization-level secrets shared with the specified repository; actual secret values are not returned and visibility depends on token access.
Lists organization-level variables that are shared with a specific repository. The repository must belong to an organization (not a personal account).
Lists a page of a repository's Projects (classic), filtered by open, closed, or all states. An empty result with a message can also indicate that the repository was not found or classic projects are not enabled. DEPRECATED: The classic Projects REST API has been sunset; use GitHub Projects V2 instead.
Lists rule suite evaluations for a repository, allowing filtering by ref (non-wildcard), time period, actor, and result.
Lists a page of metadata for GitHub Actions secrets in a repository, including names and timestamps but not secret values.
Lists a page of metadata for Dependabot secrets in a repository, including names and creation and update dates; secret values are not included.
Lists repository security advisories, optionally filtered by state and sorted or paginated.
Lists tags for a specified GitHub repository.
Lists a page of teams with explicit permission to access the specified repository; the repository must exist.
Lists plain text key-value variables for GitHub Actions workflows within a specific, accessible repository.
Retrieves a list of webhooks for a repository, which must exist and be accessible.
Lists a page of GitHub Actions workflows for a specified repository, which must exist and be accessible. The response includes the total workflow count.
Lists a page of pull request review comments across a specified repository, with sorting and pagination options.
Lists a page of review comments on a specific pull request within a GitHub repository, with sorting and pagination options.
Lists submitted reviews chronologically for a specific pull request within a GitHub repository.
Lists available self-hosted runner application binaries for a specific repository, including their OS, architecture, and download URL.
Lists downloadable GitHub Actions runner application binaries for setting up self-hosted runners in a GitHub organization. Returns download URLs and checksums for various OS/architecture combinations (linux/win/osx on x64/arm/arm64). Requires admin:org scope or fine-grained 'Self-hosted runners' read permission.
List secret scanning alerts for a GitHub repository using first-party detections. Use this to retrieve detected secrets with filtering by state, type, resolution, and validity. Supports optional hiding of secret literals for security.
Lists all Codespaces secrets accessible to the authenticated user for use within GitHub Codespaces.
Tool to list GitHub Security Advisories using the GraphQL API. Use when you need to query security vulnerabilities and malware advisories from the GitHub Advisory Database with advanced filtering and pagination options.
Query software vulnerabilities documented by GitHub Security Advisories using GraphQL. Use this to find security issues in packages across ecosystems like npm, pip, maven, etc.
Lists repositories within a specified organization that have been granted access to a particular Dependabot secret. Note: This endpoint only returns results when the secret's visibility is set to 'selected'. Secrets with visibility 'all' or 'private' do not have specific repository selections. Requires 'admin:org' scope and the user must have admin access to the organization.
Lists a page of repositories selected to access a Codespaces organization secret whose visibility is set to 'selected'. Requires admin:org scope and admin access to the organization.
Lists a page of repositories explicitly selected to access a GitHub Actions organization secret. The secret's visibility must be set to 'selected'; organization admin access and appropriate authorization are required.
Lists repositories that have access to the specified user Codespaces secret. This endpoint retrieves all repositories that the authenticated user has granted access to for a specific user-level Codespaces secret. The secret must already exist for this endpoint to work. Use 'list_secrets_for_the_authenticated_user' to discover available secrets first. Note: The authenticated user must have Codespaces access enabled. OAuth tokens and personal access tokens require the 'codespace' or 'codespace:secrets' scope.
Lists repositories in an organization that can access a specific organization variable; supports pagination and returns an empty list if no repositories have been granted access. Note: This endpoint only works for variables with visibility set to 'selected' - attempting to use it on variables with 'all' or 'private' visibility will result in a 409 Conflict error.
Lists self-hosted runners configured for a repository, with optional runner-name filtering and pagination.
Lists self-hosted runners for a GitHub organization, optionally filtering by name and paginating results, providing details for each runner such as OS, status, and labels.
Lists social media accounts publicly linked to an existing GitHub user's profile.
Lists a page of social media accounts linked to the authenticated user's GitHub profile, including links to platforms such as Twitter and LinkedIn.
Tool to list users and organizations who can be sponsored via GitHub Sponsors. Use when you need to discover sponsorable entities with optional filtering by dependency ecosystem.
Lists the public SSH signing keys for a specified GitHub user.
Lists users who have starred the specified GitHub repository, which must exist.
Lists gists starred by the authenticated GitHub user. Optionally filter to gists updated after a specified time and select a page of results, with up to 100 results per page.
Lists a page of public repositories starred by a specified GitHub user, sorted by when they were starred or last updated. Supports pagination and sort direction.
Lists the authenticated user's stubbed (test/example data, not live) GitHub Marketplace subscriptions, useful for development or testing.
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 pagination for large hierarchies.
Lists members of a specific team within an organization, including members of child teams.
Lists GitHub projects accessible to a specific team within an organization.
Lists repositories accessible to a specific team within a GitHub organization. Returns a list of repositories that the specified team has access to, including the team's permission level (admin, maintain, push, triage, pull) for each repository. Requires read:org scope and membership in the organization to access team data.
Lists teams for a specified GitHub organization.
Lists a page of teams assigned to a specific role in a GitHub organization, helping administrators audit role assignments. Requires organization administrator privileges; page size can be set from 1 to 100.
Lists all teams across all organizations to which the authenticated user belongs, supporting pagination.
Lists GitHub users that a valid GitHub `username` is following, supporting pagination.
Lists chronological events (e.g., comments, commits, label changes) for a specific issue in a GitHub repository.
Lists a page of repositories in an organization accessible to a specified fine-grained personal access token, for auditing its repository access. The caller must be an organization owner or have the Personal access tokens organization permission; the endpoint is for GitHub Apps.
Lists Projects V2 for a specified GitHub user using GraphQL, with page-based pagination and optional state filtering. State filtering is applied after fetching the page, so a page may contain fewer matching projects than requested.
Lists a page of GitHub users, including individuals and organizations, in chronological order of sign-up. Supports pagination by starting user ID and results per page.
Lists users assigned to a specific role within a GitHub organization.
Lists users blocked by a specified GitHub organization.
Lists users blocked by the authenticated user, returning an empty list if no users are blocked.
Retrieves a list of users watching a specific repository; the repository must be accessible to the authenticated user.
Lists artifacts (e.g., build outputs, test results) for a specific workflow run in a GitHub repository.
Lists workflow runs for a repository, allowing filtering by actor, branch, event, status, creation date, check suite ID, or head SHA; the repository must exist and be accessible.
Lists runs for a specified, existing workflow (identified by ID or filename like `main.yml`) in a GitHub repository, with filtering options.
Locks an existing GitHub issue's conversation, preventing further comments; an optional reason can be specified.
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 (stargazer count) and related topics.
Look up a pending enterprise administrator invitation by invitee login, enterprise slug, and role. An empty result can indicate either no invitation was returned or a GraphQL resolution or not-found error.
Look up a GitHub resource by URL and return its GraphQL type and URL.
Look up multiple GitHub nodes by their global node IDs in a single GraphQL query, returning each node's ID and type.
Tool to lookup a GitHub organization by login using GraphQL. Use when you need organization information via GraphQL API.
Sets the Codespaces access control policy for a GitHub organization, determining which members can use them. This endpoint requires admin permissions on the organization. The API returns HTTP 204 No Content on success.
Creates or updates values for an organization's predefined custom properties across multiple repositories (up to 30).
Add or remove an issue that blocks another issue in the same repository.
Updates Git author information (name and/or email) for an `author_id` obtained during a repository import, to correctly attribute commits. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports.
Marks the GitHub notification thread (identified by `thread_id`) as done or read for the authenticated user, effectively archiving it.
Marks an existing GitHub notification thread, identified by its `thread_id`, as read.
Marks notifications as read or unread, optionally for those updated at or before a `last_read_at` timestamp.
Marks a draft pull request as ready for review using GitHub GraphQL API, transitioning it from draft to reviewable state. Use this action when a draft pull request has reached a stage where it is ready for team review and can potentially be merged. This action cannot be used on pull requests that are already marked as ready for review.
Marks notifications in a repository as read; if 'last_read_at' is specified, notifications updated after this timestamp are not marked as read.
Merges a head branch or commit SHA into a base branch in a repository; fails if there are merge conflicts requiring manual resolution.
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 to ready-for-review first using GITHUB_UPDATE_A_PULL_REQUEST. (2) Branch protection rules are not satisfied - check for required approving reviews, status checks, or other repository rules that must be met before merging. (3) The base branch has been modified since the PR was last synced - update the PR branch first using GITHUB_UPDATE_A_PULL_REQUEST_BRANCH.
Pings an existing webhook on a repository to test its configuration and reachability by GitHub.
Sends a ping event to a specified existing organization webhook to test its configuration. A successful request queues the event; it does not confirm delivery.
Privately reports a security vulnerability to a repository's maintainers. IMPORTANT: You cannot report vulnerabilities to repositories you own - this API is for third-party security researchers to report to other repositories. The target repository must have private vulnerability reporting enabled. Specify EITHER `severity` OR `cvss_vector_string`, but not both.
Tool to publish a draft GitHub Sponsors tier using GraphQL. Use when you need to make a draft sponsors tier visible to potential sponsors. The tier must already exist in draft status.
Re-runs a specific job and any dependent jobs from a GitHub Actions workflow run in the specified repository, optionally enabling debug logging.
Redelivers a specific, previously made webhook delivery (`delivery_id`) for a repository's webhook (`hook_id`).
Redelivers a specific webhook delivery for a webhook within an organization, to resend an event that previously failed or was not processed.
Deletes a custom property, specified by `custom_property_name`, from an existing organization (`org`) for which the property is currently defined, preventing its future assignment to repositories.
Removes a label currently applied to a specific issue in a repository.
Removes a classic project from a team within an organization.
Removes a collaborator from a specified GitHub repository, provided the repository exists and the user is an existing collaborator.
Disassociates a repository from a team; team members may lose access permissions, but the repository and team are not deleted.
Removes a repository from a GitHub App installation for the authenticated user, given a valid `installation_id` and the `repository_id` of a repository currently linked to that installation; this operation is idempotent.
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.
Removes all labels from a specified issue in a GitHub repository; this operation is idempotent.
Revokes all organization roles for a team in an organization; this is destructive and succeeds even if the team initially has no roles.
Revokes all assigned organization-level roles from a specified user (who must be a member of the organization) within a GitHub organization, without removing the user from the organization or affecting repository-specific roles.
Removes a member from a GitHub organization. This action permanently removes a user's membership from the specified organization, revoking their access to all organization resources, repositories, and teams. Requirements: - The authenticated user must be an organization owner - The target user must currently be a member of the organization Note: This action cannot be used to remove the last owner of an organization.
Revokes an organization role that a team currently possesses within an organization.
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 corresponds to a valid custom role in that organization.
Removes all GitHub App access restrictions from a protected branch without altering user or team restrictions. A 404 is returned as an empty app list with an explanatory message rather than an exception.
Removes specified assignees from a GitHub issue; requires push access, and invalid removal attempts are silently ignored.
Removes a custom label from a repository's self-hosted runner; this operation is idempotent.
Removes a currently assigned custom label (`name`) from a self-hosted runner (`runner_id`) in an organization (`org`). This action allows the organization to manage the labels associated with their runners effectively.
Removes all custom labels from a self-hosted runner registered at the repository level, leaving only its default labels and any labels inherited from its runner group or organization.
Removes all interaction restrictions for a repository, enabling all users to comment, open issues, and create pull requests by lifting any existing temporary interaction limits.
Removes all interaction restrictions from public repositories in the specified GitHub organization, allowing all users to resume interactions.
Deletes a named GitHub Codespaces secret from an organization. A not-found response is treated as success, so success does not necessarily confirm that a secret was deleted.
Permanently removes a specific Dependabot secret, by its `secret_name`, from the GitHub `org`, making it unavailable to Dependabot for that organization.
Removes a user, who must be an outside collaborator, from the specified GitHub organization, revoking their access to all its repositories.
Removes the authenticated user's public organization membership, making it private. The user remains a member of the organization but their membership is no longer publicly visible. This operation is idempotent - calling it when the membership is already private will succeed.
Removes a repository's access to an organization-level Codespaces secret, if it was previously granted.
Removes currently assigned user logins and/or team slugs from a GitHub pull request's list of requested reviewers.
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. Only users with push access to the repository can remove review requests.
Revokes a specific repository's access to an organization-level Dependabot secret, applicable only when the secret has 'selected' visibility and the specified repository currently has access.
Removes a specific repository's access to an organization-level secret; the repository must have been previously granted access to this secret.
Removes a repository's access to an organization variable that has 'selected' visibility. This endpoint removes a specific repository from an organization variable's access list. The variable must have its visibility set to 'selected' for this operation to work. Returns a 409 Conflict error if the variable visibility is not 'selected'.
Removes specified status check contexts from a protected branch's required status checks. This action removes the specified status check contexts from the existing list of required status checks for a protected branch. The branch must already have branch protection enabled with status checks configured. Note: The 'contexts' parameter is deprecated by GitHub in favor of 'checks' array. For new implementations, consider using update_status_check_protection with the 'checks' parameter instead.
Removes status check protection from a branch, disabling required status checks for merging pull requests; will only have an effect if status check protection is currently configured on the branch.
Removes specified teams from push access to a protected branch. This action removes teams from the list of teams with push access to a protected branch. Removing a team will also remove push access for any child teams. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must currently have push access to the branch
Tool to remove team membership for a user in an organization. Use when you need to revoke a user's membership from a specific team. This action is irreversible β the user must be explicitly re-added if you want to restore their team membership. Note that if team synchronization is set up, this operation may fail with a 403 Forbidden error.
Removes a user from a specific team within an organization. This action requires admin:org scope permissions. It will fail if: - Team synchronization with an Identity Provider (IdP) is enabled (403 Forbidden) - The organization, team, or user membership doesn't exist (404 Not Found) - You don't have sufficient permissions to manage team memberships (403 Forbidden) Note: If the removed user was the last member and the team is not nested, the team may be deleted automatically.
Removes specified users from the list of people allowed to push to a protected branch. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must have protection rules with push restrictions enabled - Users being removed must currently have push access to the branch - The combined total of users, apps, and teams is limited to 100 items
Removes a user as a collaborator from an organization project (classic); a success result can also indicate that the user was already absent. The Projects (classic) REST API is sunset on GitHub.com and may still work on GitHub Enterprise Server versions before 3.17.
Removes all interaction restrictions (limitations on comments, issues, or pull requests) from all public repositories owned by the authenticated user.
Removes selected users from GitHub Codespaces billing access for an existing organization.
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 cannot contain wildcard characters.
Renders Markdown to HTML; for 'gfm' mode, provide 'context' (owner/repo) to correctly link issues, pull requests, and user mentions.
Tool to render raw Markdown text to HTML using GitHub's markdown API. Use when you need to convert plain Markdown content to HTML without GitHub-specific features like issue references or @mentions.
Reopens a closed GitHub issue by changing its state to 'open' with state_reason 'reopened'. Use this action when you need to reopen a previously closed issue that requires further attention or work. Only users with push access to the repository can reopen issues.
Reopens a previously closed pull request by setting its state to 'open'. This restores the pull request to an active state where it can be reviewed, commented on, and merged. Use this action when you need to reactivate a closed pull request that was closed prematurely or needs to be reconsidered for merging.
Replaces all topics of a repository.
Replaces the list of repositories that can access a Dependabot organization secret when the secret's visibility is already set to 'selected'.
Replaces the list of repositories that can access an organization-level Codespaces secret. This operation completely replaces the existing list of repositories with the provided list. The secret must already have its visibility set to 'selected' for this operation to succeed. Use this when you want to set an exact list of repositories that should have access. Prerequisites: - The organization must exist and you must have admin:org scope - The Codespaces secret must already exist in the organization - The secret's visibility must be set to 'selected' (not 'all' or 'private') Returns HTTP 204 No Content on success, 404 if secret/org not found, 409 if visibility is not 'selected'.
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.
Requests reviewers for a specific pull request identified by owner, repository, and pull request number. Use this action when you need to add individual users or teams as reviewers to an existing pull request. At least one of reviewers (individual users) or team_reviewers (teams) must be provided.
Triggers a re-run of a specific check run in a GitHub repository, resetting its status to 'queued', clearing its conclusion, and triggering the `check_run` webhook with `rerequested` action. IMPORTANT: This endpoint requires GitHub App authentication with 'checks:write' permission. The check run can ONLY be re-requested by the same GitHub App that originally created it. OAuth tokens and personal access tokens (PAT) cannot use this endpoint.
Triggers a new run of an existing check suite within a repository, resetting its status to 'queued', clearing its conclusion, and triggering the `check_suite` webhook with `rerequested` action. IMPORTANT: This endpoint requires GitHub App authentication with 'checks:write' permission. OAuth tokens and classic personal access tokens (PAT) cannot use this endpoint. Only GitHub App user access tokens, GitHub App installation access tokens, or fine-grained personal access tokens with checks:write permission are supported.
Re-runs a specific GitHub Actions workflow run identified by its owner, repository, and run ID, optionally enabling debug logging.
Re-runs all failed jobs and their dependent jobs from a specified workflow run if the run contains previously failed jobs.
Invalidates the provided OAuth `access_token` and generates a new one for the GitHub OAuth App identified by `client_id`. Used for token rotation when a token may be compromised or for regular security maintenance. Note: This endpoint requires the OAuth App owner's credentials (client_id/client_secret for Basic Auth).
Restores a user-owned package previously deleted from GitHub Packages, if restorable under GitHub's data retention policy (typically within 30 days of deletion).
Restores a package in an organization, provided it was deleted within the last 30 days.
Restores a package deleted by the authenticated user within the last 30 days, if its namespace and version are still available.
Restores a package version that was deleted by the authenticated user within the last 30 days.
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.
Restores a package version for an organization, provided it was deleted within the last 30 days.
Tool to retire a published payment tier from your GitHub Sponsors profile using GraphQL. Use when you need to prevent a tier from being used for new sponsorships. Existing sponsors at this tier remain unaffected.
Gets a repository's public key, used to encrypt secrets for Dependabot.
Approves or denies a pending fine-grained personal access token request for organization resources; must be performed by a GitHub App.
Approves or rejects pending custom deployment protection rules for a workflow run. This endpoint allows GitHub Apps to review their own pending custom deployment protection rules for a specific workflow run. The review can either approve (allowing the deployment to proceed) or reject (blocking the deployment). **Important notes:** - GitHub Apps can only review their own custom deployment protection rules - This endpoint requires GitHub App installation access tokens with Deployments permission (write) - Custom deployment protection rules are available in public repos for all plans; for private/internal repos, GitHub Enterprise is required - Returns 204 No Content on success
Submits a bulk approval or denial of fine-grained personal access token requests for a GitHub organization. The returned success message indicates acceptance for processing, not confirmation that every request has been processed.
Approves or rejects pending deployments for a specific workflow run that are in a 'waiting' state within specified, configured environments.
Revokes the GitHub App's current installation access token, immediately invalidating it for API authentication. IMPORTANT: This endpoint requires a GitHub App installation access token (ghs_* prefix) for authentication. OAuth tokens (gho_*) or personal access tokens are not supported and will result in a 403 Forbidden error. After successful revocation, the token becomes permanently invalid and cannot be used for any subsequent API calls. To continue API operations, a new installation access token must be generated.
Revokes a fine-grained personal access token's access to a specified GitHub organization. This operation requires a GitHub App with the organization's 'Personal access tokens' write permission; personal access tokens cannot call it. List the organization's resource access tokens to find the token ID.
Tool to run an arbitrary GitHub GraphQL v4 query or mutation. Use when fetching multiple datasets in one batch. Cost-based rate limit: ~5,000 points/hour; keep field selections narrow, avoid deep nesting, and include rateLimit in responses to monitor quota. Responses are nested under data.data (e.g., data.data.repository.vulnerabilityAlerts); always inspect the errors array even on HTTP 200, as partial failures embed there. Paginate by looping on pageInfo.hasNextPage and advancing with pageInfo.endCursor. Search results cap at ~1,000 items per query; split by label, date range, or repository for full coverage. Use ProjectV2 nodes, not Classic Projects (deprecated). Parallel mutations (e.g., addProjectV2ItemById) can trigger transient conflicts; use sequential execution.
Runs a supplied GitHub GraphQL query or mutation, including queries that access root fields through the relay context. The response may include GraphQL errors alongside data.
Searches code file contents and paths on the default branch of GitHub repositories using a query string; searches only files under 384KB, returns max 1000 results by best match, and is optimized for precision.
Searches GitHub code across multiple pages, optionally capped by a result limit; results may be partial, including because of GitHub's approximately 1,000-result cap and default-branch indexing. Queries combining parentheses with AND, OR, or NOT are rejected by the tool.
Finds commits on GitHub using a query string (q) supporting keywords and qualifiers, with options for sorting and pagination.
Searches commits across GitHub repositories using keywords and qualifiers such as author, committer email, organization, or date range. Results can be sorted by author or committer date and returned in pages of up to 100 commits.
Searches GitHub issues and pull requests using keywords and qualifiers, with sorting and pagination. Results are limited to accessible repositories and may be incomplete or subject to GitHub search limits.
Searches GitHub for issues and pull requests using keywords and qualifiers, with sorting and pagination. Standalone issue or pull request type filters must be combined with another term; @me is resolved by GitHub.
Searches for labels within a GitHub repository by keywords in their names or descriptions.
Searches GitHub repositories using a flexible query (keywords, qualifiers) with sorting, ordering, and pagination. IMPORTANT: The 'q' parameter (search query) is REQUIRED and must always be provided.
Finds topics on GitHub using keywords and qualifiers with GitHub's search syntax, supporting pagination.
Searches for users on GitHub by criteria like username, email, location, followers, or repository associations, using a flexible query string `q`.
Sets the authenticated user's notification subscription for a repository.
Sets whether a GitHub notification thread is ignored (muted) or unignored (unmuted), for a `thread_id` that must identify an existing notification thread.
Enables administrator enforcement on a branch, making existing protection rules also apply to administrators; branch protection rules must already be configured.
Sets the GitHub Actions permissions for an existing organization, specifying allowed GitHub-owned actions, verified creator actions, and action/workflow patterns from public repositories.
Replaces the list of GitHub Apps permitted to push to a protected branch; the branch must have push restrictions configured, and apps must be installed with contents write permission on an eligible organization repository. A 404 returns an empty app list with an explanatory message.
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').
Replaces all custom labels for a specific self-hosted runner in a repository; an empty list for `labels` removes all existing custom labels.
Sets the OpenID Connect (OIDC) subject claim template for a GitHub repository, allowing use of the default template or a custom one defined by `include_claim_keys` if `use_default` is `false`.
Sets the default permissions for the GITHUB_TOKEN within a repository and configures whether GitHub Actions can approve pull requests.
Updates an organization's default GITHUB_TOKEN permissions for workflows and whether GitHub Actions can approve pull requests; note that allowing Actions to approve pull requests (`can_approve_pull_request_reviews: true`) is a security risk.
Sets GitHub Actions permissions for a repository, enabling/disabling Actions and defining the policy for allowed actions and reusable workflows.
Sets the GitHub Actions permissions policy for an organization, specifying which repositories can run Actions and which actions/workflows are allowed; if 'selected' is chosen for either, manage the specific lists via other endpoints.
Temporarily limits which GitHub users (e.g., existing_users, contributors_only) can interact (comment, open issues, create pull requests) in a repository for a specified duration.
Limits interactions (comments, new issues, PRs) in an organization's public repositories by user type and duration, typically to mitigate high traffic or unwanted activity.
Sets or updates temporary interaction restrictions for all public repositories owned by the authenticated user, overriding any repository-specific limits.
Replaces all existing labels on a GitHub issue with a new set of labels.
Sets the visibility ('public' or 'private') of the authenticated user's primary email address on GitHub, if one is configured.
Sets allowed GitHub Actions and reusable workflows for a repository, managing permissions for GitHub-owned, verified creator, or specific pattern-matched actions/workflows (note: `patterns_allowed` applies only to public repositories).
Defines the list of repositories permitted to access a specific Codespaces secret for the authenticated user.
Replaces the list of repositories that can access an organization secret; only effective if the secret's visibility is 'selected'. Prerequisites: - The organization secret must already exist - The secret's visibility must be set to 'selected' (not 'all' or 'private') - Requires admin:org scope or actions secrets fine-grained permission This action completely replaces the repository access list. To add or remove individual repositories without affecting others, use the dedicated add/remove repository actions instead.
Replaces the list of repositories that can access an organization-level variable; the variable's visibility must be 'selected'.
Replaces required status check contexts for a protected branch, requiring admin permissions; an empty `contexts` array removes all checks.
Replaces the list of teams with push access to a protected branch. This action sets (replaces) the teams that have push access to a protected branch. Unlike 'Add team access restrictions' (POST), this action replaces the entire list rather than adding to it. Use an empty list to remove all team restrictions. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must exist in the organization and have repository access
Replaces the list of users with push access to a protected branch in an organization repository. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must already have protection rules with restrictions enabled - This REPLACES (not adds to) the existing list of users with push access - Users must have write access to the repository to be added - The combined total of users, apps, and teams is limited to 100 items - To add users without replacing, use the 'add_user_access_restrictions' action instead
Set interaction limits on a specified user's public repositories using GraphQL, temporarily restricting who can comment, open issues, or create pull requests.
Sets the access level for workflows outside a repository to use actions and reusable workflows within that repository.
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.
Stars a specified repository (identified by owner and repo name) for the authenticated user; this action is idempotent and succeeds even if the repository is already starred. Requires explicit repository identification via owner and repo parameters.
Initiates the startup process for an existing GitHub Codespace (identified by `codespace_name`) if it's in a startable state like 'Available' or 'Stopped'.
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. The codespace must be in a running state (e.g., 'Available') to be stopped. Required permissions: - OAuth/PAT: admin:org scope - Fine-grained tokens: 'Organization codespaces' (write) or 'Codespaces lifecycle admin' (write) Common HTTP responses: - 200: Codespace successfully stopped, returns codespace object - 304: Not modified (codespace already stopped) - 401: Authentication required - 403: Insufficient permissions (need admin:org) - 404: Organization, user, or codespace not found
Stops a running or available Codespace for the authenticated user, pausing its execution and billing.
Finalizes a pending pull request review (identified by `review_id`) with a required `event` (APPROVE, REQUEST_CHANGES, COMMENT) and an optional `body`.
Synchronizes a branch in a forked GitHub repository with its upstream counterpart, assuming the repository is a fork, the branch exists, an upstream is configured, and the merge is conflict-free.
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, otherwise, it returns 204 No Content without sending a POST.
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.
Unblocks a GitHub user, provided they are currently blocked by the authenticated user.
Unblocks a user from a specified organization. A 404 response is returned as an unsuccessful result indicating that the user was not blocked or the organization or user was not found.
Unfollows an existing GitHub user; this action is idempotent, succeeding even if the authenticated user is not currently following them.
Tool to unfollow a GitHub organization using GraphQL. Use when you need to stop following a specific organization on GitHub.
Tool to unfollow a GitHub user using GraphQL. Use when you need to stop following a specific user on GitHub.
Unlocks a repository (`repo_name`) that was locked as part of a user migration (`migration_id`), making it usable or deletable; this action requires the repository to be currently locked.
Unlocks a currently locked GitHub issue in the specified repository, allowing new comments and interactions.
Unlocks a repository that was locked for migration within a GitHub organization. This action is part of the organization migrations workflow. When you start a migration with `lock_repositories=true`, the source repositories are locked to prevent changes during export. After the migration is complete and applied to the target instance, use this action to unlock the repositories so they can be accessed or deleted. Requirements: - You must be an organization owner to unlock repositories - The repository must be currently locked as part of the specified migration - This endpoint does not work with GitHub App tokens or fine-grained personal access tokens Typical workflow: 1. Start an organization migration with POST /orgs/{org}/migrations 2. Wait for the migration to complete (state: "exported") 3. Apply the migration to your target instance 4. Unlock each migrated repository using this action 5. Delete the source repositories if no longer needed
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.
Removes the authenticated user's star from a specified repository, which must already be starred by the user.
Updates an existing check run for a specific commit in a repository, allowing modifications to its status, conclusion, output, and other details. NOTE: This endpoint requires GitHub App authentication with 'checks:write' permission - OAuth tokens and personal access tokens cannot update check runs.
Updates a specific code scanning alert in a GitHub repository, primarily to change its state (e.g., 'open' or 'dismissed').
Updates the default setup configuration for code scanning in a repository; GitHub Advanced Security must be enabled for the repository.
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.
Changes the body of an existing commit comment.
Updates an existing custom role in an organization by modifying its name, description, or permissions; at least one of these fields must be provided.
Updates the name pattern of an existing deployment branch policy for a specific environment in a repository.
Updates the title and/or body of a specific team discussion within an organization.
Updates the body of a comment in a team's discussion within an organization.
Updates a gist's description, and/or its files (including content, filename changes, or deletion).
Updates an existing comment on a specified gist.
Updates an existing label's name, color, or description within a specified repository.
Updates a repository milestone identified by owner, repository, and milestone number. It can modify the title, state, description, or due date; if state is omitted, it is sent as open.
Updates an existing GitHub project (V2) attributes like title, description, visibility, and state. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects (classic) REST API was sunset on April 1, 2025. The project is identified by its number (visible in the project URL) and owner (either a username or organization name). If no owner is specified, the authenticated user is assumed. At least one field to update must be provided.
Updates an existing pull request, allowing changes to attributes like title, body, state, base branch, and maintainer modification settings.
Requests an asynchronous update of an open pull request's head branch by merging its base branch, if mergeable and repository merging is enabled. The result may instead report merge conflicts, an already up-to-date branch, or an expected head SHA mismatch.
Updates an existing Git reference (e.g., a branch or tag) to point to a specific commit SHA. By default, only allows fast-forward updates (where the new commit is a descendant of the current one). Set `force=true` to allow non-fast-forward updates that rewrite history. IMPORTANT: The reference must already exist - use 'Create a reference' action to create new refs.
Updates an existing release in a GitHub repository, allowing modification of its attributes; if linking a discussion, the `discussion_category_name` must refer to an existing category in the repository.
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.
Updates settings for an existing GitHub repository, such as name, description, visibility, merge strategies, and security configurations.
Updates an active repository invitation to modify the invited user's permissions; the specified repository and invitation must exist.
Updates an existing repository ruleset, identified by `ruleset_id` for a given repository, allowing partial updates to its configuration such as name, target, enforcement, bypass actors, conditions, and rules.
Updates the name and/or value of an existing GitHub Actions variable in a repository.
Updates the URL, content type, secret, SSL verification, events, or active status of an existing repository webhook. The active status defaults to true when omitted.
Updates the body of an existing review comment on a pull request.
Updates the body text of an existing pull request review.
Updates a team's settings (e.g., name, description, privacy, parent team) within a GitHub organization, identified by its slug and organization name.
Updates the configuration (e.g., payload URL, content type, secret, SSL verification) for an existing webhook in a specified repository.
Updates the configuration (URL, content type, secret, SSL verification) for an existing webhook within a specified organization.
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.
Updates an existing GitHub issue's title, body, state, milestone, labels, or assignees. Empty lists can clear labels or assignees; null values are omitted from the update.
Updates an existing comment on an issue or pull request within a specified repository. You can only update comments that the authenticated user has permission to edit. The comment_id can be obtained from the list_issue_comments or get_an_issue_comment actions.
Updates an organization's settings; changing security-related fields requires admin, owner, or security manager permissions. Omitted repository-permission, repository-creation, Pages, private-forking, and web-commit signoff settings are sent with the tool's defaults and may change existing settings.
Updates an existing GitHub Actions organization variable's name, value, or visibility (`all`, `private`, `selected`), requiring `selected_repository_ids` with valid repository IDs if visibility is `selected`.
Updates an existing organization's webhook configuration, subscribed events, active status, or name. If active status is omitted, the request enables the webhook.
Updates branch protection settings for a specific existing repository branch; wildcard branch names are not supported. Unspecified status checks, admin enforcement, pull request reviews, and push restrictions are sent as null and may be disabled; unspecified user, team, or app lists within supplied push restrictions are sent empty.
Sets the Git Large File Storage (LFS) preference for a repository during a source import. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports.
Update an existing issue type for a GitHub organization. Requires the authenticated user to be an organization administrator. OAuth tokens need admin:org scope.
Tool to update a field value for an item in a user's GitHub ProjectV2. Use when you need to modify a field value of an existing project item.
Updates pull request review protection settings for a branch, including required approvals, review dismissal, and bypass allowances. The last-push approval setting defaults to false and is sent even when omitted; branch protection features must be available for the repository.
Updates repository preferences for automatic Check Suite creation on code pushes, allowing configuration for specific GitHub Apps that must be installed on the repository with `checks:write` permission.
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 be valid and associated with the organization. AUTHENTICATION REQUIREMENT: This endpoint requires GitHub App authentication with 'Personal access tokens' organization permissions (write). Standard personal access tokens CANNOT use this endpoint. The GitHub App must also have access to the organization.
Updates required status checks for a branch, optionally requiring it to be up-to-date before merging.
Tool to update notification subscription state for issues, pull requests, or discussions. Use when you need to subscribe, unsubscribe, or ignore notifications for a specific GitHub item.
Updates the authenticated user's GitHub profile; a new public email must be verified, and existing private emails remain private even if specified.
Tool to update an existing GitHub user list. Use when you need to modify the name, description, or privacy settings of a user list.
Tool to update which of the viewer's lists an item belongs to on GitHub. Use when you need to add an item (repository, issue, pull request, etc.) to specific user lists or move it between lists.
Tool to upload a binary asset to an existing GitHub release. Use when you need to attach files like installers or backups to a release programmatically.
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.
Checks GitHub credentials using the authenticated-user endpoint and returns a validity flag and username when available. A 403 also returns valid=false and may indicate rate limiting or insufficient permissions rather than invalid credentials.
Verifies if the authenticated user has accepted permissions for a specific devcontainer configuration in a repository, typically to ensure awareness before a codespace is created or used.
Return the identity (login, name) of the connected GitHub account.
Nothing matches that.
More in Developer tools
See them all βSupabase is an open-source backend-as-a-service providing a Postgres database, authentication, storage, and real-time subscription APIs for buildingβ¦
230 toolsβ BBitbucket is a Git-based code hosting and collaboration platform supporting private and public repositories, enabling teams to manage and review codeβ¦
116 toolsβ SIntegrate Sentry to manage your error tracking and monitoring.
210 toolsβ CCoinbase is a platform for buying, selling, transferring, and storing cryptocurrency.
28 toolsβ AAppDrag is a cloud-based platform for building websites, APIs, and databases with drag-and-drop tools, code editing, and integrated hosting toβ¦
11 toolsβ LA feature management platform that helps teams build better software faster using feature flags.
248 toolsβ