Connect GitHub to Claude Sonnet (Anthropic) to unlock the power of AI automation

add-a-repository-collaborator

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.

add-a-repository-to-an-app-installation

Adds a repository to a GitHub app installation, granting the app access; requires authenticated user to have admin rights for the repository and access to the installation.

add-a-selected-repository-to-a-user-secret

Grants a specified repository access to an authenticated user's existing codespaces secret, enabling codespaces created for that repository to use the secret.

add-assignees-to-an-issue

Adds or removes assignees for a GitHub issue; changes are silently ignored if the authenticated user lacks push access to the repository.

add-labels-to-an-issue

Adds labels (provided in the request body) to a repository issue; labels that do not already exist are created.

add-org-runner-labels

Adds new custom labels to an existing self-hosted runner for an organization; existing labels are not removed, and duplicates are not added.

add-or-update-team-membership-for-a-user

Adds a GitHub user to a team or updates their role (member or maintainer), inviting them to the organization if not already a member; idempotent, returning current details if no change is made.

add-or-update-team-project-permissions

Grants or updates a team's permissions ('read', 'write', or 'admin') for a specific project, which must exist within the specified organization and be linked to it.

add-or-update-team-repository-permissions

Sets or updates a team's permission level for a repository within an organization; the team must be a member of the organization.

add-project-collaborator

Adds a specified GitHub user as a collaborator to an existing organization project with a given permission level.

add-repo-to-org-secret-with-selected-access

Adds a repository to an existing organization-level GitHub actions secret that is configured for 'selected' repository access.

add-repo-to-org-secret-with-selected-visibility

Grants an existing repository access to an existing organization-level dependabot secret; the repository must belong to the organization, and the call succeeds without change if access already exists.

add-runner-labels

Adds and appends custom labels to a self-hosted repository runner, which must be registered and active.

add-selected-repository-to-an-organization-secret

Adds a repository to an organization secret's access list when the secret's visibility is 'selected'; this operation is idempotent.

add-selected-repository-to-an-organization-variable

Grants a repository access to an organization-level GitHub actions variable, if that variable's visibility is set to 'selected repositories'.

add-social-accounts-for-the-authenticated-user

Adds one or more social media links (which must be valid, full urls for platforms supported by GitHub) to the authenticated user's public GitHub profile.

add-status-check-contexts

Adds status check contexts (provided in the request body, e.

add-team-access-restrictions

Overwrites the list of teams (and their child teams) granted push access to a protected branch; the list of team slugs must be provided in the http post request body.

add-user-access-restrictions

Sets/replaces list of users allowed to push to a protected branch; usernames (e.

add-users-to-codespaces-access-for-an-organization

Sets or replaces the list of organization members granted codespaces access billed to the organization; ensure the organization's billing settings allow access for selected members.

approve-a-workflow-run-for-a-fork-pull-request

Approves a workflow run from a forked repository's pull request; call this when such a run requires manual approval due to workflow configuration.

assign-an-organization-role-to-a-team

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.

assign-an-organization-role-to-a-user

Assigns a specific organization role to a user who is a member or an outside collaborator in a GitHub organization, using a valid role id.

auth-user-docker-conflict-packages-list

Lists docker packages for the authenticated user that encountered conflicts during the docker migration process.

block-a-user

Blocks an existing individual GitHub user (not an organization or your own account), preventing them from interacting with your account and repositories.

block-a-user-from-an-organization

Blocks an existing GitHub user from an existing organization, preventing their contributions, collaboration, and forking of the organization's repositories.

cancel-a-github-pages-deployment

Cancels an existing, ongoing or queued GitHub pages deployment for a repository using its `pages deployment id`.

cancel-a-workflow-run

Cancels a workflow run in a GitHub repository if it is in a cancellable state (e.

check-a-token

Checks if a GitHub app or oauth access token is valid for the specified client id and retrieves its details, typically to verify its active status and grants.

check-if-a-gist-is-starred

Checks if a gist, identified by `gist id`, is starred by the authenticated user, returning an empty response (204) if starred, or a 404 error if not starred or not found.

check-if-a-person-is-followed-by-the-authenticated-user

Checks if the authenticated GitHub user follows a target GitHub user; an http 204 status indicates the user is followed, while an http 404 status indicates the user is not followed or the target user does not exist.

check-if-a-pull-request-has-been-merged

Checks if a specified GitHub pull request has been merged, indicated by a 204 http status (merged) or 404 (not merged/found).

check-if-a-repository-is-starred-by-the-authenticated-user

Use to determine if the authenticated user has starred a specific GitHub repository, which is confirmed by an http 204 status (resulting in an empty dictionary in the response data); the action fails (e.

check-if-a-user-can-be-assigned

Verifies if a GitHub user can be assigned to issues in a repository; assignability is confirmed by an http 204 (no content) response, resulting in an empty 'data' field in the response.

check-if-a-user-can-be-assigned-to-a-issue

Checks if a specified GitHub user can be assigned to a given issue within a repository.

check-if-a-user-follows-another-user

Checks if a GitHub user `username` follows `target user`; returns a 204 http status if true, 404 if not or if users are invalid.

check-if-a-user-is-a-repository-collaborator

Checks if a user is a collaborator on a specified GitHub repository, returning a 204 status if they are, or a 404 status if they are not or if the repository/user does not exist.

check-if-a-user-is-blocked-by-an-organization

Checks if a GitHub user is blocked by an organization; a successful response (204 no content) indicates the user is blocked, while a 404 not found error indicates the user is not blocked.

check-if-a-user-is-blocked-by-the-authenticated-user

Checks if the specified GitHub user is blocked by the authenticated user; a 204 no content response indicates the user is blocked, while a 404 not found indicates they are not.

check-private-vulnerability-reporting-status

Checks if private vulnerability reporting is enabled for the specified repository.

check-team-permissions-for-a-project

Checks if a team has 'read', 'write', or 'admin' permissions for an organization's specific classic project, returning the project's details if access is confirmed.

check-team-permissions-for-a-repository

Checks a team's permissions for a specific repository within an organization, including permissions inherited from parent teams.

clear-repository-cache-by-key

Deletes GitHub actions caches from a repository matching a specific `key` and an optional git `ref`, used to manage storage or clear outdated/corrupted caches; the action succeeds even if no matching caches are found to delete.

clear-self-hosted-runner-org-labels

Removes all custom labels from a self-hosted runner for an organization; default labels (e.

compare-two-commits

Compares two commit points (commits, branches, tags, or shas) within a repository or across forks, using `base.

configure-jitrunner-for-org

Generates a jit configuration for a GitHub organization's new self-hosted runner to run a single job then unregister; the runner group id must exist.

configure-oidcsubject-claim-template

Sets or updates the oidc subject claim customization template for an existing GitHub organization by specifying which claims (e.

convert-an-organization-member-to-outside-collaborator

Converts an existing organization member, who is not an owner, to an outside collaborator, restricting their access to explicitly granted repositories.

create-a-blob

Creates a git blob in a repository, requiring content and encoding ('utf-8' or 'base64').

create-a-check-run

Creates a new check run for a specific commit in a repository, used by external services to report status, detailed feedback, annotations, and images directly within the GitHub ui.

create-a-check-suite

Creates a new check suite for a specific commit (`head sha`) in an original repository (not a fork); GitHub dispatches a `check suite` webhook event with the `requested` action upon success.

create-a-codespace-for-the-authenticated-user

Creates a GitHub codespace for the authenticated user, requiring a json request body with either `repository id` (integer) or a `pull request` object (containing `pull request number` (integer) and `repository id` (integer)).

create-a-codespace-from-a-pull-request

Creates a GitHub codespace for an open pull request in a codespaces-enabled repository, with options to customize its configuration.

create-a-codespace-in-a-repository

Creates a GitHub codespace for the authenticated user in a specified repository, which must be accessible and use a valid `devcontainer.

create-a-commit

Creates a new commit in a GitHub repository; the `tree` sha and any `parents` shas must already exist in the repository.

create-a-commit-comment

Creates a comment on a specific commit, or on a specific line if `path` and `position` are provided.

create-a-commit-status

Sets a commit's status (e.

create-a-custom-organization-role

Creates a custom role with defined permissions within a GitHub organization.

create-a-deploy-key

Creates a deploy key for a repository; the repository must exist and be accessible, and the provided key must be a valid public ssh key.

create-a-deployment

Creates a GitHub deployment for an existing repository, targeting a specific ref (branch, tag, or sha) that must also exist within the repository.

create-a-deployment-branch-policy

Creates a deployment branch or tag policy for an existing environment in a GitHub repository, using a ruby file.

create-a-deployment-status

Creates a status for an existing deployment, updating its operational state, associated urls, and description.

create-a-discussion

Creates a new discussion post on a specific team's page within an organization.

create-a-discussion-comment

Creates a new comment on an existing team discussion within a GitHub organization.

create-a-fork

Creates a fork of an accessible repository, optionally into a specific organization, with a new name, or copying only the default branch.

create-a-gist

Creates a new gist on GitHub with provided files, an optional description, and public/secret visibility.

create-a-gist-comment

Creates a new comment on a specified GitHub gist.

create-a-github-app-from-a-manifest

Use this action to finalize a GitHub app's creation by exchanging the temporary `code` (received as a url parameter during the app manifest setup redirection) for the app's full configuration details.

create-a-github-pages-deployment

Creates a GitHub pages deployment for a repository using a specified artifact and oidc token, provided GitHub pages is enabled and the artifact (containing static assets) is accessible.

create-a-github-pages-site

Configures or updates GitHub pages for a repository, setting build type and source; ensure a pages workflow exists for 'workflow' `build type`, or `source branch` exists for 'legacy' or unspecified `build type`.

create-a-label

Creates a new label in a specified GitHub repository, provided the repository exists and the user has write permissions.

create-a-milestone

Creates a milestone in a GitHub repository for tracking progress on issues or pull requests; requires repository existence and user write permissions.

create-an-autolink-reference-for-a-repository

Creates a repository autolink to automatically convert text references (e.

create-an-environment-variable

Creates an encrypted environment variable for a pre-existing environment within a GitHub repository; will fail if the variable name already exists.

create-an-issue

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.

create-an-issue-comment

Creates a new comment on an existing GitHub issue or pull request within the specified repository.

create-an-organization-project

Creates a new classic project board within a specified GitHub organization.

create-an-organization-repository

Creates a new repository within a specified GitHub organization, with options for detailed configuration including visibility, features, merge strategies, initial commit, and templates.

create-an-organization-variable

Creates a new, uniquely named GitHub actions variable for an organization, with configurable repository access visibility (all, private, or selected).

create-an-organization-webhook

Creates a webhook for a GitHub organization to deliver event notifications to a configured url.

create-a-project-card

Creates a project card in a GitHub project column; the request body must contain either a `note` for a note-only card, or both `content id` (id of an issue or pull request) and `content type` (e.

create-a-project-column

Creates a new column in a GitHub project (classic).

create-a-pull-request

Creates a pull request in a GitHub repository, requiring existing `base` and `head` branches; `title` or `issue` must be provided.

create-a-reference

Creates a git reference (e.

create-a-registration-token-for-an-organization

Generates a temporary (one-hour) registration token to add a new self-hosted runner to an organization for GitHub actions.

create-a-registration-token-for-a-repository

Generates a time-limited token required to register a new self-hosted runner with a specific repository.

create-a-release

Creates a release in a GitHub repository for a specified tag; the tag must be unique for published releases, and if a `discussion category name` is given, it must already exist.

create-a-remove-token-for-an-organization

Generates a token, valid for one hour, to authenticate removing a self-hosted runner from an organization.

create-a-remove-token-for-a-repository

Generates a temporary (one-hour validity) token required to unregister and remove a self-hosted runner from a repository.

create-a-reply-for-a-review-comment

Posts a reply to a specific review comment on a GitHub pull request, requiring the repository, pull request, and original comment to exist, and a non-empty reply body.

create-a-repository-dispatch-event

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.

create-a-repository-for-the-authenticated-user

Creates a new repository for the authenticated user, optionally within an organization if `team id` is specified.

create-a-repository-from-an-unpublished-codespace

Publishes the specified codespace to a new repository, using the codespace's current state as the initial commit.

create-a-repository-project

Creates a new classic project board within a specified repository; classic projects must be enabled for the target repository.

create-a-repository-ruleset

Creates a uniquely named ruleset for a repository, defining rules for branches or tags with specified enforcement, conditions, and bypass actors.

create-a-repository-using-a-template

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.

create-a-repository-variable

Creates a new, unencrypted variable in a repository for GitHub actions workflows; fails if a variable with the same name already exists.

create-a-repository-webhook

Creates a webhook for a specified repository; requires admin permissions on the repository.

create-a-review-comment-for-a-pull-request

Creates a review comment on a pull request's diff, targeting a specific line, range of lines, an entire file, or replying to an existing comment.

create-a-review-for-a-pull-request

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`.

create-a-scoped-access-token

Exchanges a user-to-server token for a new, fine-grained scoped access token for a GitHub app, requiring `client id`, `access token`, either `target` or `target id`, and at least one permission; for repository-specific scoping, provide either `repositories` (names) or `repository ids` (ids), but not both.

create-a-snapshot-of-dependencies-for-a-repository

Creates a snapshot of a repository's dependencies to populate the GitHub dependency graph and enable security alerts; `sha` must be a 40-character commit id, `ref` a fully qualified git reference (e.

create-a-tag-object

Creates an annotated git tag object in a repository, pointing to an existing git object (commit, tree, or blob) defined by its sha and ensuring the `type` field correctly specifies the object's type.

create-a-tag-protection-state-for-a-repository

Creates a tag protection rule for a repository using a glob pattern; note: tag protections are deprecated (sunset august 30, 2024), migrate to repository rulesets.

create-a-team

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'.

create-a-temporary-private-fork

Creates a temporary private fork of the specified repository to address a security vulnerability, linking the fork to a ghsa id that must be specifically associated with this repository; the fork may take up to 5 minutes to become accessible.

create-a-tree

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.

create-a-user-project

Creates a new GitHub project board for the authenticated user to organize and track issues, pull requests, and notes.

create-a-workflow-dispatch-event

Manually triggers a GitHub actions workflow identified by `workflow id` at a given `ref`, if the workflow is configured to accept `workflow dispatch` events.

create-commit-signature-protection

Enables commit signature protection for a specified branch, requiring all new commits to be signed.

create-deployment-protection-rule

Enables a custom deployment protection rule for an existing environment in a repository by linking a configured GitHub app (via `integration id`) to control deployments.

create-jit-runner-config

Generates a temporary just-in-time (jit) configuration for a new self-hosted GitHub actions runner for a repository; any specified non-default `runner group id` must be an existing runner group accessible by the repository.

create-or-update-a-custom-property-for-an-organization

Creates a new custom property (name must be unique for creation) or updates an existing one for an organization to define metadata for its repositories.

create-or-update-an-environment

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.

create-or-update-an-environment-secret

Creates or updates an environment secret with an `encrypted value` that was encrypted using the public key identified by `key id` for the specified environment.

create-or-update-an-organization-secret

Creates or updates an organization secret for GitHub actions, requiring its value to be pre-encrypted via libsodium using the organization's public key.

create-or-update-a-repository-secret

Creates or updates a GitHub actions secret within a specific repository; use `encrypted value` and `key id` to set or change its value.

create-or-update-a-secret-for-the-authenticated-user

Creates or updates a codespaces secret for the authenticated user; `encrypted value` must be encrypted with the public key (id: `key id`) from GitHub's 'get public key for the authenticated user' endpoint.

create-or-update-custom-properties-for-an-organization

Creates new custom property schemas or updates existing ones in bulk for a specified organization; each property definition must include `property name` and `value type`.

create-or-update-custom-property-values-for-a-repository

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.

create-or-update-file-contents

Creates a new file or updates an existing file in a GitHub repository; provide `sha` to update an existing file, otherwise a new file is created.

create-or-update-repo-secret-with-encrypted-value

Creates or updates a dependabot secret in a repository using an `encrypted value` (pre-encrypted with libsodium using the repository's dependabot public key) and its corresponding `key id`.

create-reaction-for-a-commit-comment

Creates an emoji reaction for a commit comment; if the user has already reacted with the same content, details of the existing reaction are returned.

create-reaction-for-an-issue

Creates a reaction for a specified issue within a GitHub repository.

create-reaction-for-an-issue-comment

Creates a reaction for a specific comment on an issue within a GitHub repository.

create-reaction-for-a-pull-request-review-comment

Adds a specified reaction to a pull request review comment within a GitHub repository.

create-reaction-for-a-release

Creates an emoji reaction for a specific, existing release in a GitHub repository.

create-reaction-for-a-team-discussion

Creates a reaction for a team discussion within a GitHub organization.

create-reaction-for-a-team-discussion-comment

Adds a reaction to a team discussion comment, requiring the specified organization, team, discussion, and comment to exist.

create-update-org-secret-with-lib-sodium

Creates or updates a dependabot organization secret, requiring the secret value to be pre-encrypted with libsodium using the organization's public key obtained from the 'get an organization public key' endpoint.

customize-oidc-subject-claim-template

Retrieves the openid connect (oidc) subject claim customization template for a repository, which defines the `sub` claim structure in oidc tokens for GitHub actions workflows; returns the default configuration if no customization is applied.

custom-oidcsubject-claim-template

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.

custom-oidcsubject-claim-template-setter

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`.

decline-a-repository-invitation

Declines a specific, pending repository invitation for the authenticated user, identified by its `invitation id`.

delete-access-restrictions

Removes all user, team, and app-based access restrictions from a protected branch.

delete-a-code-scanning-analysis-from-a-repository

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.

delete-a-codespace-for-the-authenticated-user

Deletes a specific codespace owned by the authenticated user; this is a destructive action and the codespace must exist.

delete-a-codespace-from-the-organization

Permanently deletes a specific codespace belonging to a member of the specified organization.

delete-a-commit-comment

Deletes a specific commit comment, identified by its `comment id`, from the specified repository; the comment must exist.

delete-a-commit-comment-reaction

Deletes a reaction from a commit comment in a GitHub repository.

delete-a-custom-organization-role

Deletes a custom organization role (which should not be actively assigned) by its id; a 204 no content response indicates success.

delete-a-deploy-key

Deletes a specific deploy key from a repository; to change a key's properties or access scope, the existing key must be deleted and a new one created.

delete-a-deployment

Permanently deletes a specified *inactive* deployment from a repository.

delete-a-deployment-branch-policy

Deletes a specific deployment branch or tag policy, identified by its id, from a given environment within a repository.

delete-a-discussion

Deletes a specific team discussion, identified by its number, from an organization's team.

delete-a-discussion-comment

Deletes a specific comment from an existing team discussion within an organization, provided the specified organization, team, discussion, and comment all exist.

delete-admin-branch-protection

Removes admin enforcement from a protected branch (branch name cannot contain wildcard characters) in a repository.

delete-a-file

Deletes a file by path from a GitHub repository, requiring a commit message and the file's current blob sha to confirm the deletion.

delete-a-gist

Permanently deletes an existing GitHub gist, specified by its `gist id`; this action is destructive and cannot be undone.

delete-a-gist-comment

Deletes a specific comment from a GitHub gist using its `gist id` and `comment id`.

delete-a-github-pages-site

Deletes the GitHub pages site for the specified repository; completes without error if no site is currently enabled.

delete-a-label

Permanently removes an existing label from a repository.

delete-a-milestone

Deletes the specified milestone if it exists; this operation is idempotent, typically returning a 404 if the milestone is not found or already deleted.

delete-an-app-authorization

Revokes a single, specific oauth access token for an oauth app, not all authorizations for the app.

delete-an-app-token

Revokes an oauth access token for a GitHub app, if the app exists and the token was issued to it.

delete-an-artifact

Deletes a GitHub artifact by its id within a repository, typically resulting in an empty response (http 204 no content) on success.

delete-an-autolink-reference-from-a-repository

Deletes a specific autolink reference (which automatically links external resource ids like jira-123 to urls) from the specified repository.

delete-an-email-address-for-the-authenticated-user

Sends an empty request body to `delete /user/emails` to attempt deletion of user email addresses; the API typically requires specific emails, so outcome may vary.

delete-an-environment

Deletes an existing deployment environment from an existing repository.

delete-an-environment-secret

Deletes an existing and accessible secret from a specified environment within a GitHub repository, returning an empty dictionary on success or error details otherwise.

delete-an-environment-variable

Deletes a named environment variable from a specified, existing environment within a GitHub repository.

delete-an-issue-comment

Permanently deletes a specific comment by its id from an issue or pull request, if the repository exists and the comment id is valid.

delete-an-issue-comment-reaction

Deletes a reaction from an issue comment in a repository; the repository, comment, and reaction must exist.

delete-an-issue-reaction

Permanently removes a specific reaction from an issue in a GitHub repository.

delete-an-organization

Deletes a GitHub organization and its repositories; this is a destructive action and the organization name will be unavailable for reuse for approximately 90 days.

delete-an-organization-secret

Permanently deletes a secret from a GitHub organization, making it inaccessible to GitHub actions workflows or other tools.

delete-an-organization-variable

Deletes a named GitHub actions variable from a specified organization.

delete-an-organization-webhook

Deletes a specific webhook, identified by `hook id`, from an existing organization.

delete-a-package-for-an-organization

Deletes a specific package in an organization; cannot delete public packages with over 5,000 downloads.

delete-a-package-for-a-user

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.

delete-a-package-for-the-authenticated-user

Permanently deletes a specific package owned by the authenticated user; public packages downloaded over 5,000 times cannot be deleted via this API.

delete-a-package-version-for-the-authenticated-user

Deletes an existing package version associated with the authenticated user.

delete-a-pending-review-for-a-pull-request

Deletes a pending (unsubmitted) review from a pull request; this is only possible if the review has not yet been submitted.

delete-a-project

Deletes the GitHub project specified by `project id` if the project exists and the projects feature is enabled for its repository or organization; a successful deletion results in a 204 no content response.

delete-a-project-card

Deletes a project card from a GitHub 'project (classic)'; this operation is idempotent.

delete-a-project-column

Deletes a project column by its id from a GitHub project (classic); this is a destructive operation.

delete-a-pull-request-comment-reaction

Deletes a specific reaction from a pull request review comment, provided the comment and reaction exist on that comment within the specified repository.

delete-a-reference

Deletes a git reference from a repository; 'ref' must be fully qualified (e.

delete-a-release

Permanently deletes a specific release, its assets, and potentially its associated git tag from a repository.

delete-a-release-asset

Deletes a specific release asset from a GitHub repository; this action is idempotent.

delete-a-release-reaction

Deletes a reaction from a GitHub release, provided the repository, release, and reaction exist.

delete-a-repository

Permanently deletes the specified repository; this is a destructive, irreversible action that requires admin privileges for the repository.

delete-a-repository-invitation

Deletes an active repository invitation, permanently revoking a user's access to collaborate on the specified repository.

delete-a-repository-ruleset

Permanently deletes a repository ruleset.

delete-a-repository-secret

Deletes a named GitHub actions secret from a specified repository; this operation is destructive and idempotent, and requires the repository to exist.

delete-a-repository-subscription

Deletes the authenticated user's subscription to a specified repository if it exists, effectively 'unwatching' it.

delete-a-repository-variable

Deletes a named variable (e.

delete-a-repository-webhook

Deletes a specific webhook from a repository.

delete-a-review-comment-for-a-pull-request

Deletes a specific pull request review comment.

delete-a-secret-for-the-authenticated-user

Deletes an existing codespaces secret for the authenticated user by `secret name`; this is a destructive, irreversible, and idempotent operation.

delete-a-self-hosted-runner-from-an-organization

Deletes an existing and registered self-hosted runner from an organization, typically returning 204 no content on success.

delete-a-self-hosted-runner-from-a-repository

Removes a specific self-hosted runner (by `runner id`) from a repository, if registered there; this is idempotent.

delete-a-tag-protection-state-for-a-repository

Permanently deletes a specific tag protection rule, identified by its id, from the given repository.

delete-a-team

Deletes a team (and any child teams) from an organization.

delete-a-thread-subscription

Call this to mute a specific notification thread by deleting the user's subscription; notifications may still occur if the user is @mentioned, comments, or due to repository watch settings.

delete-a-workflow-run

Deletes a specific workflow run from a repository.

delete-branch-protection

Removes all protection rules from a specific branch in a GitHub repository; the branch must currently have protection rules enabled.

delete-commit-signature-protection

Disables gpg commit signature protection for a specific branch in a GitHub repository, meaning commits pushed to this branch no longer require gpg signing.

delete-dependebot-secret-by-name

Deletes a specific dependabot secret, identified by its name, from a given repository if both the repository and secret exist.

delete-github-actions-cache-by-id

Deletes a specific GitHub actions cache from a repository using its unique `cache id`.

delete-package-version-for-an-organization

Deletes a specific package version within an organization; requires admin permissions for packages with over 5,000 downloads.

delete-package-version-for-a-user

Permanently and irreversibly deletes a specific version of a package owned by the specified user.

delete-pull-request-review-protection

Disables the requirement for pull request reviews before merging for a specific, existing branch in an existing repository; this action is idempotent and will succeed even if the protection is not currently enabled.

delete-repo-codespace-secret-by-name

Deletes a specific codespace secret from a repository by its name; this action is idempotent and will succeed even if the secret doesn't exist.

delete-social-accounts-for-the-authenticated-user

Deletes currently linked social media account urls from the authenticated user's GitHub profile.

delete-team-discussion-comment-reaction

Deletes a reaction from a team discussion comment, given the organization name, team slug, discussion number, comment number, and reaction id.

delete-team-discussion-reaction

Permanently deletes a specific reaction from a team discussion within an organization.

delete-workflow-run-logs

Deletes all logs for a specific workflow run in a GitHub repository, provided the repository and run exist.

disable-a-custom-protection-rule-for-an-environment

Disables a specific, currently active custom deployment protection rule for an existing environment within a GitHub repository.

disable-a-workflow

Disables a specified workflow (by id or filename) in a given GitHub repository, preventing new automatic triggers; any in-progress runs will continue.

disable-private-vulnerability-reporting-for-a-repository

Disables private vulnerability reporting for an existing GitHub repository, preventing direct private vulnerability reports to maintainers via GitHub's interface for this repository.

disable-repository-actions-in-org

Disables GitHub actions for a specific repository within an organization; this action is only effective if the organization's GitHub actions `enabled repositories` setting is configured to `selected`.

dismiss-a-review-for-a-pull-request

Dismisses a review on a pull request with a mandatory explanatory message.

download-an-artifact

Downloads a specific GitHub repository artifact, returning a temporary url to its 'zip' archive, valid for one minute.

download-a-repository-archive-tar

Downloads a repository's source code as a tarball (.

download-a-repository-archive-zip

Downloads a repository's source code as a zip archive for a specific git reference (branch, tag, or commit sha).

download-job-logs-for-a-workflow-run

Downloads logs for a specific job in a GitHub actions workflow run, contingent on the repository's existence and the job id being valid and having produced logs.

download-workflow-run-attempt-logs

Downloads a zip archive of logs for a specific workflow run attempt.

download-workflow-run-logs

Downloads logs for a specific GitHub actions workflow run, typically archived as a zip file, if logs are available (e.

emo-j-is-get

Lists all emojis available for use on GitHub; deprecated, use `get emojis` instead.

enable-a-workflow

Reactivates a currently disabled GitHub actions workflow within a repository using its numerical id.

enable-github-actions-in-selected-repositories

Sets the specific repositories that can use GitHub actions within an organization by replacing the current list; only applies if the organization's actions policy is 'selected repositories'.

enable-private-vulnerability-reporting-for-a-repository

Enables private vulnerability reporting for a repository, allowing security researchers to privately submit vulnerability reports to maintainers.

enable-repo-forgithub-actions

Enables GitHub actions for a repository if the organization's actions permissions are set to allow for 'selected repositories'.

encrypt-and-update-dev-secret

Creates or updates a repository's development environment secret using an `encrypted value` and its corresponding `key id`; the secret must be pre-encrypted with the repository's codespaces public key.

encrypt-org-dev-env-secret

Creates or updates an organization's GitHub codespaces secret using an encrypted value and its corresponding public key id.

encrypt-org-secrets-using-public-key

Retrieves an organization's public key, which must be used to encrypt secret values before they are configured for codespaces.

export-a-codespace-for-the-authenticated-user

Triggers an export of a user's specified codespace, automatically stopping it if active, and returns its export status and download url.

export-a-software-bill-of-materials-sbom-for-a-repository

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-public-key-for-secret-encryption

Retrieves the public key for an existing GitHub organization, required for encrypting dependabot secrets.

find-pull-requests

Ai-optimized pull request search with smart filtering by repo, author, state, labels, and merge status.

find-repositories

Ai-optimized repository search with smart filtering by language, stars, topics, and ownership.

follow-a-user

Allows the authenticated user to follow the GitHub user specified by `username`; this action is idempotent and the user cannot follow themselves.

force-cancel-a-workflow-run

Forcefully cancels an existing GitHub actions workflow run, bypassing normal cancellation conditions; requires write permissions to the repository.

fork-a-gist

Forks a specified public gist, creating a copy under the authenticated user's account.

generate-release-notes-content-for-a-release

Generates markdown release notes content (listing changes, pull requests, and contributors) for a GitHub repository release, customizable via tags and a configuration file.

get-a-blob

Retrieves the raw, typically base64-encoded, content of a file (blob) from a GitHub repository using its sha hash, if the repository and blob sha exist.

get-a-branch

Retrieves detailed information for a specified branch within a GitHub repository.

get-access-restrictions

Lists users, teams, and GitHub apps with push access to a branch; this branch must be protected in repository settings for detailed restrictions, otherwise expect a 404 or empty response.

get-a-check-run

Retrieves detailed information for a specific check run within a GitHub repository.

get-a-check-suite

Retrieves a specific check suite (a collection of check runs) by its id from a repository accessible to the authenticated user.

get-a-classroom

Retrieves details for a specific GitHub classroom; the classroom id must correspond to an existing classroom.

get-a-code-of-conduct

Retrieves the full details of a specific GitHub code of conduct using its unique key.

get-a-code-ql-database-for-a-repository

Gets an existing codeql database (including a download url) for a specified language in an accessible repository, if one has been successfully built for that language.

get-a-code-scanning-alert

Retrieves a specific code scanning alert, which identifies potential code vulnerabilities or errors, by its number from the specified GitHub repository.

get-a-code-scanning-analysis-for-a-repository

Retrieves detailed information for a specific code scanning analysis on an accessible repository, identified by its `analysis id`.

get-a-code-scanning-default-setup-configuration

Gets the default setup configuration for code scanning in a repository, including state, languages, query suite, and schedule for a repository if it exists.

get-a-codespace-for-the-authenticated-user

Call to retrieve detailed information for a `codespace name` belonging to the authenticated user, ensuring the codespace exists and is accessible.

get-a-commit

Retrieves a specific commit from a repository by its owner, name, and a valid commit reference (sha, branch, or tag), supporting pagination for large diffs.

get-a-commit-comment

Retrieves the full details of a specific commit comment in a GitHub repository, using its unique identifier.

get-a-commit-object

Retrieves detailed information (including author, committer, message, tree, parents, verification) for a specific commit in a GitHub repository, identified by its sha.

get-a-custom-deployment-protection-rule

Retrieves a specific custom deployment protection rule (used by GitHub apps for external validation or manual approval of deployments) for a given environment in a repository.

get-a-custom-property-for-an-organization

Retrieves the definition (schema) of a specific, existing custom property for an organization.

get-a-delivery-for-a-repository-webhook

Retrieves a specific delivery for a repository webhook, identified by its `hook id` and `delivery id`.

get-a-deploy-key

Gets a specific deploy key, identified by its `key id`, for the GitHub repository specified by `owner` and `repo`.

get-a-deployment

Gets a specific deployment by id from a repository, provided the repository and deployment id exist.

get-a-deployment-branch-policy

Retrieves a specific deployment branch policy for an environment in a repository, identified by its unique id.

get-a-deployment-status

Retrieves a specific deployment status by its id for a given deployment within a GitHub repository.

get-a-diff-of-the-dependencies-between-commits

Gets the dependency diff between two git revisions in a repository, where 'basehead' specifies the revisions and 'name' can optionally scope to a specific manifest file.

get-a-discussion

Fetches a specific discussion by its number from a team within an organization.

get-a-discussion-comment

Fetches a specific comment from a team discussion within a specific organization.

get-admin-branch-protection

Checks if repository administrators are subject to the branch protection rules on a specific branch.

get-a-dns-health-check-for-github-pages

Retrieves the dns health check status (e.

get-a-gist

Fetches a specific GitHub gist by its `gist id`, returning comprehensive details if the gist exists.

get-a-gist-comment

Retrieves a specific gist comment by its id and the gist's id.

get-a-gist-revision

Retrieves a specific revision of a gist.

get-a-github-pages-site

Retrieves information for a GitHub pages site, which must be enabled for the repository.

get-a-gitignore-template

Retrieves a specific .

get-a-job-for-a-workflow-run

Retrieves detailed information for a specific job within a GitHub actions workflow run, given its `job id` which must be valid for the specified repository's workflow.

get-a-label

Retrieves a specific label by its name from a specified GitHub repository.

get-a-license

Call this action to retrieve comprehensive details for a specific software license recognized by GitHub, using its unique license key.

get-all-api-versions

Retrieves all officially supported, date-based (e.

get-all-autolinks-of-a-repository

Retrieves all autolinks (e.

get-all-codes-of-conduct

Retrieves all available codes of conduct from GitHub, often used to select one for a repository.

get-all-commonly-used-licenses

Retrieves a list of commonly used software licenses from GitHub, optionally filtering for 'featured' licenses whose specific selection criteria by GitHub may vary.

get-all-contributor-commit-activity

Retrieves commit activity (total commits, weekly additions/deletions/commits) for all contributors to a repository; may require a retry if GitHub returns 202 while preparing data.

get-all-custom-properties-for-an-organization

Gets the schema definitions for all custom properties configured for an organization, not the specific values assigned to repositories.

get-all-custom-property-values-for-a-repository

Gets all custom property values for a repository, which may include default values or be empty if no properties are explicitly set.

get-all-deployment-protection-rules-for-an-environment

Lists all enabled custom deployment protection rules for a specific environment in a repository; the environment must exist and be configured for deployments.

get-all-gitignore-templates

Retrieves all available .

get-all-organization-roles-for-an-organization

Lists all custom organization roles for an existing GitHub organization.

get-all-repository-rulesets

Retrieves all rulesets for a GitHub repository, which define conditions and actions for repository interactions (e.

get-all-repository-topics

Retrieves all topics for a specified, existing, and accessible repository.

get-all-requested-reviewers-for-a-pull-request

Gets all users and teams requested to review a specific pull request in a repository.

get-all-status-check-contexts

Fetches all required status check contexts for a protected branch; returns an empty list if the branch isn't protected or has no required checks.

get-a-milestone

Retrieves detailed information for a specific milestone within a GitHub repository by its number.

get-an-app

Retrieves publicly available information for an existing GitHub app, identified by its unique url-friendly `app slug`.

get-an-artifact

Gets a specific artifact for a repository by `artifact id`.

get-an-assignment

Retrieves detailed information for a specific GitHub classroom assignment if the authenticated user is an administrator of the classroom.

get-an-autolink-reference-of-a-repository

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.

get-an-environment

Get an environment.

get-an-environment-public-key

Retrieves the public key for a specified GitHub repository environment, used to encrypt secrets for GitHub actions.

get-an-environment-secret

Get an environment secret.

get-an-environment-variable

Get an environment variable.

get-an-issue

Get an issue.

get-an-issue-comment

Get an issue comment.

get-an-issue-event

Get an issue event.

get-an-organization

Get an organization.

get-an-organization-public-key

Get an organization public key.

get-an-organization-role

Retrieves a specific GitHub organization role by its id.

get-an-organization-secret

Gets an organization secret's metadata (e.

get-an-organization-variable

Retrieves details (name, value, visibility, timestamps) of a specific, existing variable for an existing GitHub organization.

get-an-organization-webhook

Retrieves the full configuration, including subscribed events and delivery settings, for an existing organization webhook.

get-a-package-for-an-organization

Retrieves a specific package (by type and name) from an organization, if both the package and organization exist.

get-a-package-for-a-user

Retrieves metadata for a specific package owned by a GitHub user, using package type, name, and username as identifiers.

get-a-package-for-the-authenticated-user

Retrieves detailed information for a specific package owned by the authenticated user.

get-a-package-version-for-an-organization

Retrieves detailed information for a specific version of a package within an organization.

get-a-package-version-for-a-user

Retrieves a specific public package version associated with a GitHub user.

get-a-package-version-for-the-authenticated-user

Retrieves detailed information for an existing specific package version associated with the authenticated user, identified by its type, name, and version id.

get-apps-with-access-to-the-protected-branch

Lists GitHub apps with push access to a repository's protected branch.

get-a-project

Retrieves detailed information for a specific GitHub project using its unique `project id`.

get-a-project-card

Retrieves all details of a specific project card, given its unique `card id`.

get-a-project-column

Retrieves detailed information for a specific project column; the column must exist.

get-a-pull-request

Retrieves a specific pull request from a GitHub repository using its owner, repository name, and pull request number.

get-a-reference

Retrieves a specific git reference (e.

get-a-release

Gets a specific release from a GitHub repository, provided the repository is accessible and the release exists.

get-a-release-asset

Gets metadata for a specific release asset in a GitHub repository, including a `browser download url` for downloading the asset.

get-a-release-by-tag-name

Gets a release from a GitHub repository by its tag name; the repository and a release with this tag must already exist.

get-a-repository

Retrieves detailed information about an existing and accessible GitHub repository.

get-a-repository-public-key

Gets a repository's public key for encrypting secrets to be used in GitHub actions, if the repository exists and is accessible.

get-a-repository-readme

Fetches the readme file (if it exists and is accessible) from a specified GitHub repository, returning its base64-encoded content and metadata.

get-a-repository-readme-for-a-directory

Retrieves the readme file from a specified directory within a GitHub repository, optionally at a given commit, branch, or tag.

get-a-repository-ruleset

Retrieves a specific repository ruleset by its id; if `includes parents` is true, the search for this `ruleset id` also extends to rulesets from parent organizations.

get-a-repository-rule-suite

Gets detailed information for a specific repository rule suite by its id, including its evaluation status and the results of its individual rules.

get-a-repository-secret

Gets metadata (name, creation/update timestamps) for an existing repository secret, excluding its encrypted value.

get-a-repository-subscription

Gets the authenticated user's subscription details for a repository, indicating if they receive notifications.

get-a-repository-variable

Gets a specific GitHub actions variable by name from an accessible repository.

get-a-repository-webhook

Returns the configuration of an existing webhook for a given repository.

get-a-review-comment-for-a-pull-request

Retrieves a specific pull request review comment by its id, provided the repository exists, is accessible, and the comment id is valid.

get-a-review-for-a-pull-request

Retrieves a specific review for a pull request using its owner, repository, pull request number, and review id.

get-a-secret-for-the-authenticated-user

Retrieves metadata (name, timestamps, visibility; not the value) for a specific, existing development environment secret associated with the authenticated user's GitHub codespaces.

get-a-self-hosted-runner-for-an-organization

Retrieves detailed information about a specific self-hosted runner registered within a GitHub organization.

get-a-self-hosted-runner-for-a-repository

Gets a specific self-hosted runner for a repository by its unique id.

get-assignment-grades

Retrieves all grades for an existing GitHub classroom assignment.

get-a-tag

Retrieves detailed information for a specific git tag object from a GitHub repository, using the sha of the tag object itself.

get-a-team-by-name

Retrieves a GitHub team by its slug from a specific organization.

get-a-thread

Retrieves a specific GitHub notification thread using its unique `thread id`.

get-a-thread-subscription-for-the-authenticated-user

Retrieves the authenticated user's subscription details for a specific notification thread, identified by `thread id`.

get-a-tree

Retrieves a git tree (directory listing) from a GitHub repository using its sha, branch name, or tag name, optionally fetching all nested items recursively.

get-a-user

Retrieves the public profile information for an existing GitHub user, specified by their username.

get-a-webhook-configuration-for-an-organization

Retrieves the configuration for a specific webhook associated with a GitHub organization.

get-a-webhook-configuration-for-a-repository

Returns the configuration for an existing webhook on the specified repository.

get-a-webhook-delivery-for-an-organization-webhook

Returns detailed information for a specific delivery attempt of a webhook configured for the specified GitHub organization.

get-a-workflow

Retrieves detailed information for a specific GitHub actions workflow in a repository, identified by either its numeric id or its filename.

get-a-workflow-run

Gets a specific workflow run by its id from a GitHub repository.

get-a-workflow-run-attempt

Retrieves detailed information for a specific attempt of a workflow run in a GitHub repository, including its status, conclusion, and timings.

get-branch-protection

Retrieves branch protection settings for a specific, existing, and accessible branch in a GitHub repository; protection feature availability varies by GitHub product plan.

get-commit-authors

Fetches commit authors identified during a repository import, used to map authors from an external vcs to GitHub accounts.

get-commit-signature-protection

Gets the commit signature protection status for a branch in a repository.

get-community-profile-metrics

Retrieves a repository's community profile metrics, including health percentage and the presence of key community files (e.

get-contextual-information-for-a-user

Gets contextual hovercard information for a GitHub user; `subject type` and `subject id` can be jointly provided for more specific details.

get-default-attributes-for-a-codespace

Get pre-flight data (e.

get-default-workflow-permissions-for-an-organization

Gets the default GitHub token workflow permissions and settings for a GitHub organization.

get-default-workflow-permissions-for-a-repository

Gets the default workflow permissions (`read` or `write`) for the GitHub token and whether it can approve pull request reviews in an existing and accessible repository.

get-details-about-a-codespace-export

Retrieves detailed information about a specific export of a codespace.

get-emojis

Lists all emojis available for use on GitHub, including custom and unicode emojis.

get-feeds

Fetches a list of available GitHub feed urls for the authenticated user.

get-github-actions-cache-usage-for-an-organization

Retrieves total GitHub actions cache usage statistics for an organization, including active cache count and size across all repositories.

get-github-actions-cache-usage-for-a-repository

Retrieves the total count of active GitHub actions caches and their combined size in bytes for a specified repository.

get-github-actions-permissions-for-an-organization

Gets the GitHub actions permissions for a specified organization, detailing repository enablement and allowed actions policies.

get-github-actions-permissions-for-a-repository

Gets the GitHub actions permissions policy for a repository, including its enabled status and the scope of allowed actions.

get-github-meta-information

Fetches GitHub's publicly available metadata, useful for configuring network security policies or ip allow-listing.

get-github-pages-build

Retrieves detailed information about a specific GitHub pages build for a repository, which must have GitHub pages enabled.

get-information-about-a-sarif-upload

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.

get-interaction-restrictions-for-an-organization

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.

get-interaction-restrictions-for-a-repository

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.

get-interaction-restrictions-for-your-public-repositories

Retrieves currently active interaction restrictions for the authenticated user's public repositories.

get-large-files

Lists files larger than 100mb identified during a previous source import for the specified repository; this endpoint is deprecated and will be removed on april 12, 2024.

get-latest-pages-build

Retrieves information about the most recent GitHub pages build for a repository, which must exist, be accessible, have GitHub pages enabled, and have at least one prior build.

get-octocat

Fetches an ascii art representation of GitHub's octocat, suitable for text-based displays.

get-org-allowed-actions

Retrieves the GitHub actions permissions policy, including allowed actions and reusable workflows, for a specified organization.

get-org-dev-environment-secret-safely

Retrieves metadata for a specific secret available to an organization's GitHub codespaces without exposing its encrypted value.

get-page-views

Retrieves page view statistics for a repository over the last 14 days, including total views, unique visitors, and a daily or weekly breakdown.

get-pending-deployments-for-a-workflow-run

Retrieves pending deployment environments for a specific workflow run that are awaiting approval due to protection rules.

get-project-permission-for-a-user

Retrieves a collaborator's permission level (admin, write, read, or none) for an existing GitHub project.

get-public-key-for-secret-encryption

Retrieves a repository's public key for encrypting GitHub codespaces secrets; requires `repo` scope or equivalent read access to codespaces secrets for private repositories.

get-public-key-for-the-authenticated-user

Retrieves the authenticated user's public GitHub key, used to encrypt secrets for GitHub codespaces.

get-pull-request-review-protection

Retrieves the pull request review protection settings for a specific branch in a GitHub repository, if such protection is configured.

get-rate-limit-status-for-the-authenticated-user

Retrieves the authenticated user's current GitHub API rate limit status, including usage and limits across different resource categories.

get-repo-dev-env-secret

Gets metadata (name, creation/update timestamps) for a specific, existing development environment secret (codespaces secret) in a repository, without exposing its value.

get-repository-clones

Retrieves the total number of clones and a breakdown of clone activity (daily or weekly) for a specified repository over the preceding 14 days.

get-repository-content

Retrieves a file's base64 encoded content or a directory's metadata (but not a listing of its contents) from a GitHub repository path.

get-repository-permissions-for-a-user

Retrieves a specific user's permission level ('admin', 'write', 'read', or 'none') for a given repository, where 'maintain' role is reported as 'write' and 'triage' as 'read'.

get-repository-secret-securely

Retrieves metadata for an existing dependabot secret in a repository, without exposing its encrypted value.

get-rules-for-a-branch

Retrieves all active rules for a specific branch in a GitHub repository, excluding rules in 'evaluate' or 'disabled' status.

get-single-org-secret-without-decryption

Retrieves metadata (e.

get-status-checks-protection

Retrieves the status check protection settings for a specific branch in a GitHub repository, if status check protection is enabled for it.

get-team-membership-for-a-user

Retrieves a user's role and membership status within a specific team in an organization.

get-teams-with-access-to-the-protected-branch

Lists teams with explicit push access to a protected branch, provided team restrictions are configured in the branch's protection settings; returns an empty list otherwise.

get-the-authenticated-user

Gets the profile information for the currently authenticated GitHub user, including potentially private details based on user settings.

get-the-combined-status-for-a-specific-reference

Retrieves the aggregated commit status (e.

get-the-hourly-commit-count-for-each-day

Retrieves the 'punch card' data, showing hourly commit counts for each day of the week for an existing and accessible repository.

get-the-last-year-of-commit-activity

Fetches weekly commit totals and daily commit counts for the last 52 weeks for a specified GitHub repository.

get-the-latest-release

Fetches the latest official (non-prerelease, non-draft) release for a GitHub repository; requires at least one such published release.

get-the-license-for-a-repository

Retrieves the license file and its details for a repository, optionally from a specific git reference (branch, tag, or commit sha).

get-the-review-history-for-a-workflow-run

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.

get-the-status-of-a-github-pages-deployment

Retrieves the status of a specific GitHub pages deployment for a repository, which must have GitHub pages enabled.

get-the-weekly-commit-activity

Fetches the weekly commit activity (additions and deletions per week) for a repository over the past year; best for repositories with under 10,000 commits.

get-the-weekly-commit-count

Retrieves the weekly commit count for a repository, detailing commits by the owner and all contributors over the last 52 weeks; GitHub may return a 202 status or an empty response if statistics are being computed.

get-the-zen-of-github

Retrieves a random quote from GitHub's 'zen of GitHub' collection, reflecting GitHub's design philosophies and offering humorous insights, useful for displaying GitHub wisdom or a lighthearted message.

get-top-referral-paths

Fetches the top 10 most viewed content paths for a repository from the last 14 days.

get-top-referral-sources

Fetches the top 10 websites that referred traffic to a repository within the last 14 days.

get-users-with-access-to-the-protected-branch

Lists users with explicit push access to a protected branch, provided its protection rule restricts pushes to specific users.

get-workflow-external-access

Gets the access level settings for a private repository, determining how workflows outside this repository can use its actions and reusable workflows.

get-workflow-run-usage

Gets the billable time, in milliseconds, for a specific workflow run, detailing time spent on various operating systems.

get-workflow-usage

Gets the billable time (in milliseconds, broken down by runner os) for a specific workflow within a repository for the current billing cycle.

gist-s-create

Deprecated: use `create a gist` instead.

gist-s-list-public

(deprecated: use `list public gists` instead) lists public gists from GitHub, optionally filtering by a 'since' timestamp and supporting pagination; results are generally newest first.

github-api-root

Retrieves a map of all top-level GitHub rest API resource urls and their templates.

github-get-repo-allowed-actions

Gets the settings for allowed actions and reusable workflows that can be run in the specified repository.

github-set-repo-runner-labels

Replaces all custom labels for a specific self-hosted runner in a repository; an empty list for `labels` removes all existing custom labels.

issues-create

(deprecated: use `create an issue` instead) creates a new issue in a GitHub repository, provided issues are enabled and the user has sufficient permissions.

issues-create-comment

Deprecated: use `create an issue comment` to create a comment on an existing GitHub issue or pull request.

issues-get

Deprecated: use the `get an issue` action instead to retrieve details for a specific issue in a repository.

issues-list-assign-ees

Deprecated: use `list assignees`.

issues-list-events-for-repo

Lists all issue events for a specified repository.

issues-list-for-repo

Lists all issues (including pull requests) in a GitHub repository; deprecated: use list repository issues.

list-accepted-assignments-for-an-assignment

Lists accepted assignments (student repositories created after acceptance) for an existing GitHub classroom assignment, identified by its unique `assignment id`.

list-app-installations-accessible-to-the-user-access-token

Lists GitHub app installations accessible to the authenticated user via their access token, including installation details, permissions, and repository access.

list-artifacts-for-a-repository

Lists GitHub actions workflow artifacts for a specified repository, which must exist.

list-assigned-issues

Lists GitHub issues for the authenticated user, defaulting to 'assigned' but filterable by other interactions, state, labels, and time, with sorting and pagination.

list-assignees

Lists users who can be assigned to issues in a repository, typically those with push access.

list-assignments-for-a-classroom

Lists all assignments for a given GitHub classroom `classroom id`; the classroom must exist and be accessible.

list-available-machine-types-for-a-repository

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.

list-branches

Lists branches for an existing GitHub repository, with an option to filter by protection status.

list-branches-for-head-commit

Lists branches in an accessible repository where the provided commit sha is the head, useful for identifying development lines based on that commit.

list-check-run-annotations

Lists annotations for a specific check run in a GitHub repository, detailing issues like errors or warnings on particular code lines.

list-check-runs-for-a-git-reference

Lists check runs for a given git reference within a repository; ensure the reference exists and the repository is accessible.

list-check-runs-in-a-check-suite

Lists check runs for a specific check suite in a GitHub repository, optionally filtering by check name or status.

list-check-suites-for-a-git-reference

Lists check suites for a git reference (commit sha, branch, or tag) in a repository, optionally filtering by GitHub app id or check run name.

list-child-teams

Lists the immediate child teams of a parent team within an organization.

list-classrooms

Lists GitHub classrooms to which the authenticated user has administrative access.

list-codeowners-errors

Lists syntax errors in a repository's codeowners file, which must be located at the root, `.

list-code-ql-databases-for-a-repository

Lists all codeql databases for a repository where codeql analysis has been previously run and completed.

list-code-scanning-alerts-for-an-organization

Lists code scanning alerts for a GitHub organization; use either `tool name` or `tool guid` if filtering by tool, not both.

list-code-scanning-alerts-for-a-repository

Lists code scanning alerts for a repository, optionally filtering by tool (which must have produced scan results for the repository), git reference, state, or severity.

list-code-scanning-analyses-for-a-repository

Lists code scanning analyses for an existing repository, optionally filtering by tool (name or guid), git reference, or sarif id.

list-codespaces-for-a-user-in-organization

Lists all GitHub codespaces owned by a specified member of a given organization.

list-codespaces-for-the-authenticated-user

Lists GitHub codespaces for the authenticated user, optionally filtering by repository id and supporting pagination.

list-codespaces-for-the-organization

Lists active/pending GitHub codespaces for an existing organization; admins list all, members list their own.

list-comments-for-a-pull-request-review

Lists all comments for a specific review on a GitHub pull request.

list-commit-comments

Retrieves all comments for a specific commit in a GitHub repository, supporting pagination.

list-commit-comments-for-a-repository

Lists all commit comments for a specified repository, which must exist and be accessible.

list-commits

Retrieves commits for a repository, optionally filtering by sha (must be valid commit sha or existing branch), path, author, committer, or date range.

list-commits-on-a-pull-request

Lists commits for a pull request; requires the repository and pull request to exist and be accessible, and supports pagination.

list-commit-statuses-for-a-reference

Lists commit statuses for a specific reference (commit sha, branch, or tag) in a repository, useful for tracking ci/test outcomes.

list-custom-property-values-for-organization-repositories

Lists custom property values for repositories in a specified, existing organization, optionally filtered by a repository query.

list-deliveries-for-an-organization-webhook

Retrieves a list of webhook deliveries for a specific webhook in an organization, allowing inspection of delivery history and details.

list-deliveries-for-a-repository-webhook

Retrieves delivery attempts for a specific repository webhook to inspect its history; ensure the webhook id exists.

list-deploy-keys

Lists deploy ssh keys for a specified repository; the repository must exist.

list-deployment-branch-policies

Lists all deployment branch policies for a specified environment in a GitHub repository.

list-deployments

Lists deployments for a specified repository; repository must exist.

list-deployment-statuses

Lists all statuses for a given deployment in a repository.

list-discussion-comments

Lists all comments for a specific team discussion within an organization.

list-discussions

Lists discussions for a specific team within an organization, with options for sorting, pagination, and filtering by pinned status.

list-email-addresses-for-the-authenticated-user

Lists all email addresses for the authenticated user, including their primary status, verification status, and visibility.

list-environment-custom-deployment-rules

Lists all custom deployment protection rule integrations for a repository environment; the `environment name` must be url-encoded.

list-environments

Retrieves all deployment environments for a specified repository, which are used to configure protection rules and secrets for different software lifecycle stages.

list-environment-secrets

Lists the names and metadata (not values) of secrets for a specified, existing environment within an existing GitHub repository.

list-environment-variables

Lists all environment variables, which are plaintext key-value pairs for GitHub actions workflows, for a specified environment within a GitHub repository.

list-events-for-the-authenticated-user

Lists public events for the specified GitHub user, or private events if authenticated as that user, in reverse chronological order.

list-events-received-by-the-authenticated-user

Lists events a specific GitHub user received from followed users and watched repositories; returns private events if authenticated for `username`, otherwise public.

list-followers-of-a-user

Lists followers for a specified, existing GitHub user.

list-followers-of-the-authenticated-user

Lists users following the authenticated GitHub user, returning an empty list if the user has no followers.

list-forks

Lists forks for a specified repository, which must exist, with options for sorting and pagination.

list-gist-comments

Lists comments for a specified GitHub gist.

list-gist-commits

Lists all commits for a specified gist.

list-gist-forks

Lists all forks for a given GitHub gist id.

list-gists-for-a-user

Lists public gists for a specified GitHub user.

list-gists-for-the-authenticated-user

Lists gists for the authenticated user, with optional filtering by update time and pagination.

list-github-actions-caches-for-a-repository

Lists GitHub actions caches for a repository, with options to filter by git reference or cache key, and to sort and paginate results.

list-github-pages-builds

Lists GitHub pages builds for a repository; GitHub pages must be enabled on the repository for builds to be listed.

list-global-security-advisories

Lists GitHub's global security advisories, filterable by various attributes including id, type, ecosystem, severity, and dates.

list-installation-requests-for-the-authenticated-app

Lists pending installation requests made by users or organizations for the authenticated GitHub app.

list-instances-of-a-code-scanning-alert

Lists all instances of a specific code scanning alert, optionally filtered by git ref; requires code scanning to be enabled on the repository.

list-issue-comments

Lists comments for a specified issue in a GitHub repository.

list-issue-comments-for-a-repository

Lists issue comments, including those on pull requests, for an accessible repository.

list-issue-events

Retrieves a list of all events for a specific issue within a GitHub repository.

list-issue-events-for-a-repository

Lists all issue events (e.

list-issues-assigned-to-the-authenticated-user

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.

list-jobs-for-a-workflow-run

Lists jobs for a specific workflow run in a GitHub repository.

list-jobs-for-a-workflow-run-attempt

Lists jobs, including details like id, status, and steps, for a specific attempt of a GitHub actions workflow run.

list-labels-for-an-issue

Lists all labels for a specified issue in a GitHub repository.

list-labels-for-a-repository

Retrieves all labels for a specified, existing GitHub repository.

list-labels-for-a-self-hosted-runner-for-an-organization

Lists all labels assigned to a specific self-hosted runner within a GitHub organization, which are used to route workflows.

list-labels-for-a-self-hosted-runner-for-a-repository

Lists all labels assigned to a specific self-hosted runner registered with the given repository.

list-labels-for-issues-in-a-milestone

Lists all labels for issues within a specific milestone in a repository.

list-machine-types-for-a-codespace

Lists available machine types for a specific, accessible codespace, enabling it to be transitioned to a new hardware configuration.

list-matching-references

Lists all git references (branches or tags) in a repository that start with the provided partial reference path (e.

list-milestones

Lists milestones, which track progress for groups of issues and pull requests, for an existing repository, allowing filtering by state and sorting.

list-notifications-for-the-authenticated-user

Lists notifications for the authenticated user, sorted by most recent update, with filtering and pagination options.

list-organization-events-for-the-authenticated-user

Lists events within a specified organization that were performed by the authenticated user, whose `username` (path parameter) must match the API request credentials.

list-organization-members

Lists public and concealed members of a GitHub organization; viewing concealed members requires authenticated user to be an organization member.

list-organization-projects

Lists projects for a specified GitHub organization, optionally filtering by state and supporting pagination.

list-organization-repositories

Retrieves a list of repositories for a specified GitHub organization, allowing filtering by type and sorting.

list-organizations

Lists GitHub organizations for the authenticated user, sorted by id in ascending order.

list-organization-secrets

Lists GitHub actions secrets available for a specified organization.

list-organizations-for-a-user

Lists public organizations for a specified GitHub user; the `username` must be a valid GitHub handle.

list-organizations-for-the-authenticated-user

Lists organizations the authenticated GitHub user is a member of, returning details for each organization.

list-organization-variables

Lists all GitHub actions variables for a specified organization.

list-organization-webhooks

Lists all webhooks for a specified GitHub organization; the organization must exist.

list-org-fine-grained-permissions

Retrieves all fine-grained permissions for a specified GitHub organization, essential for creating or updating custom roles.

list-org-issues-for-user

Lists issues for the authenticated user within a specified GitHub organization, with options to filter by involvement type, state, labels, and to sort results.

list-org-level-codespaces-secrets

Lists all codespaces secrets available for a specified organization, which must exist.

list-org-package-versions

Lists all versions for a specified package, if it exists and is owned by the given GitHub organization.

list-org-repos-withgithub-actions-enabled

Lists repositories in an organization with GitHub actions enabled, for use when the organization's policy restricts actions to a specific list of repositories rather than enabling it for all.

list-org-resource-access-tokens

Lists approved fine-grained personal access tokens (pats) with access to resources in a GitHub organization, optionally filtering by owner, repository, permissions, or last usage time.

list-org-resources-with-personal-tokens

Retrieves a list of an organization's fine-grained personal access token requests (pending, approved, or denied), with options for filtering and sorting.

list-org-secrets-without-values

Lists all dependabot secrets (metadata like names, creation/update timestamps, but not their encrypted values) for a specified organization, which must exist.

list-outside-collaborators-for-an-organization

Lists outside collaborators for a GitHub organization, with options to filter (e.

list-owned-package-versions

Lists all versions for an existing package owned by the authenticated user, identified by its type and name.

list-packages-for-an-organization

Lists GitHub packages for an organization, noting specific interpretations for package type and visibility parameters.

list-packages-for-a-user

Lists packages for a specified GitHub user, filterable by package type and visibility.

list-packages-for-the-authenticated-user-s-namespace

Lists packages of a specific type and visibility within the authenticated user's namespace on GitHub.

list-package-versions-for-a-package-owned-by-a-user

Lists all versions of a public package owned by a specific GitHub user, identified by package type, package name, and username.

list-pending-team-invitations

Lists all pending membership invitations for a specified team within an organization.

list-project-cards

Lists all project cards for a given `column id`, which must correspond to an existing project column.

list-project-collaborators

Fetches a list of collaborators for a specified, existing GitHub project.

list-project-columns

Lists all of a GitHub project's columns (e.

list-public-email-addresses-for-the-authenticated-user

Lists the public email addresses for the authenticated user.

list-public-events

Lists public GitHub events, which may be delayed by up to 5 minutes, with support for pagination.

list-public-events-for-a-network-of-repositories

Retrieves public events (up to 90 days old, newest first) for a GitHub repository network, including the repository and its forks.

list-public-events-for-a-user

Retrieves a list of public events for a specified GitHub user, in reverse chronological order.

list-public-events-received-by-a-user

Lists public events for a specified GitHub user (e.

list-public-gists

Lists public gists from GitHub, optionally filtering by a 'since' timestamp and supporting pagination; results are generally newest first.

list-public-keys-for-a-user

Lists the verified public ssh keys for a specified GitHub user.

list-public-organization-events

Lists public events for a specified GitHub organization, which must exist.

list-public-organization-members

Lists users who have publicly declared their membership in a specified, existing GitHub organization.

list-public-repositories

Lists all public repositories on GitHub; use the `since` parameter with a repository id from a previous result for pagination.

list-pull-requests

Lists pull requests for a specified GitHub repository with ai-friendly filtering.

list-pull-requests-associated-with-a-commit

Lists pull requests for a commit; returns merged prs that introduced the commit if on the default branch, or open prs including the commit if on other branches.

list-pull-requests-files

Lists all files (including additions, modifications, and removals) associated with a specific pull request in a GitHub repository.

list-reactions-for-a-commit-comment

Lists reactions for a specific commit comment; this is a read-only operation.

list-reactions-for-an-issue

Lists reactions for a specific, existing issue within an accessible GitHub repository, optionally filtering by content type.

list-reactions-for-an-issue-comment

Lists reactions for a specific issue comment in a GitHub repository, optionally filtering by content type.

list-reactions-for-a-pull-request-review-comment

Lists reactions for a pull request review comment in a repository, optionally filtering by reaction type.

list-reactions-for-a-release

Lists all reactions, or optionally filters reactions by a specific content type, for a given GitHub release.

list-reactions-for-a-team-discussion

Lists reactions for an existing team discussion within an organization.

list-reactions-for-a-team-discussion-comment

Lists reactions for a specific comment in a team discussion within an organization, optionally filtering by content type.

list-release-assets

Lists assets (e.

list-releases

Retrieves a list of all releases (published, draft, and prerelease) for a specified repository.

list-repo-access-by-token

Lists repositories in an organization that a fine-grained personal access token (`pat request id`) has requested access to; must be performed by a GitHub app.

list-repo-codespaces

Lists codespaces the authenticated user can access within a specified, existing repository.

list-repo-dev-container-configs-for-user

Lists the `devcontainer.

list-repo-secrets-without-values

Lists all codespaces secrets available in a specific repository, without their encrypted values.

list-repositories-accessible-to-the-app-installation

Lists repositories an app installation can access; 'total count' in response is zero if none are accessible.

list-repositories-accessible-to-the-user-access-token

Lists repositories accessible to the authenticated user through a specific GitHub app installation (identified by `installation id`).

list-repositories-for-a-user

Lists public repositories for a specified GitHub user, who must have an existing account.

list-repositories-for-the-authenticated-user

Lists repositories for the authenticated user; using 'type' with 'visibility' or 'affiliation' API parameters (not in this model) can cause a 422 error.

list-repositories-starred-by-a-user

Lists repositories a valid and existing GitHub user has starred.

list-repositories-starred-by-the-authenticated-user

Lists repositories the authenticated user has starred, optionally sorted and paginated, including star creation timestamps via 'application/vnd.

list-repositories-watched-by-a-user

Lists repositories a given GitHub user is watching; the username must be a valid and existing GitHub user handle.

list-repositories-watched-by-the-authenticated-user

Lists repositories the authenticated user is watching (subscribed to for notifications).

list-repository-activities

Lists activities for a GitHub repository, ensuring the repository exists and is accessible.

list-repository-collaborators

Lists collaborators for a specified repository, provided it exists and is accessible to the authenticated user.

list-repository-contributors

Lists contributors to a specified repository, sorted by number of contributions in descending order; the repository must exist and be accessible.

list-repository-events

Lists chronological events (e.

list-repository-invitations

Retrieves all pending (unaccepted or undeclined) collaboration invitations for a specified GitHub repository.

list-repository-invitations-for-the-authenticated-user

Lists all pending repository invitations for the authenticated user.

list-repository-issues

Lists issues (which include pull requests) for a specified, existing GitHub repository, with options for filtering, sorting, and pagination.

list-repository-languages

Lists the programming languages used in a GitHub repository, returning a byte count for each language.

list-repository-notifications-for-the-authenticated-user

Retrieves notifications for the authenticated user from a specified repository, to which the user must have access.

list-repository-organization-secrets

Lists names of organization-level secrets shared with the specified repository; actual secret values are not returned and visibility depends on token access.

list-repository-organization-variables

Lists organization variables accessible to a specific repository; the repository must exist.

list-repository-projects

Lists projects associated with a specific repository.

list-repository-rule-suites

Lists rule suite evaluations for a repository, allowing filtering by ref (non-wildcard), time period, actor, and result.

list-repository-secrets

Lists metadata for all secrets in a GitHub repository, excluding their encrypted values.

list-repository-secrets-without-decrypting

Lists metadata (e.

list-repository-tags

Lists tags for a specified GitHub repository.

list-repository-teams

Lists all teams with explicit permission to access the specified repository; the repository must exist.

list-repository-variables

Lists plain text key-value variables for GitHub actions workflows within a specific, accessible repository.

list-repository-webhooks

Retrieves a list of webhooks for a repository, which must exist and be accessible.

list-repository-workflows

Lists all GitHub actions workflows for a specified repository, which must exist and be accessible.

list-repos-with-ghactions-cache-usage

Retrieves a paginated list of GitHub actions cache usage statistics for repositories within an existing GitHub organization.

list-review-comments-in-a-repository

Lists all review comments on all pull requests within a specified repository.

list-review-comments-on-a-pull-request

Lists all review comments on a specific pull request within a GitHub repository.

list-reviews-for-a-pull-request

Lists submitted reviews chronologically for a specific pull request within a GitHub repository.

list-runner-applications-for-an-organization

Lists downloadable GitHub actions runner application binaries, used for setting up self-hosted runners, for an existing GitHub organization.

list-runner-applications-for-a-repository

Lists available self-hosted runner application binaries for a specific repository, including their os, architecture, and download url.

list-secrets-for-the-authenticated-user

Lists all codespaces secrets accessible to the authenticated user for use within GitHub codespaces.

list-selected-repos-for-secret-access

Lists repositories within a specified organization that have been granted access to a particular dependabot secret.

list-selected-repositories-for-an-organization-secret

Lists repositories within an organization that have explicit access to a specific organization secret, which must have its visibility set to 'selected'.

list-selected-repositories-for-an-organization-variable

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.

list-selected-repositories-for-a-user-secret

Lists repositories that have access to the specified user secret for the authenticated user's codespaces, provided the user has codespaces access.

list-self-hosted-runners-for-an-organization

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.

list-self-hosted-runners-for-a-repository

Lists all self-hosted runners configured for a repository.

list-social-accounts-for-a-user

Lists social media accounts publicly linked to an existing GitHub user's profile.

list-social-accounts-for-the-authenticated-user

Lists all social media accounts linked to the authenticated user's GitHub profile.

list-stargazers

Lists users who have starred the specified GitHub repository, which must exist.

list-starred-gists

Retrieves a list of gists starred by the authenticated user.

list-subscriptions-for-the-authenticated-user

Lists the authenticated user's active GitHub marketplace subscriptions.

list-subscriptions-for-the-authenticated-user-stubbed

Lists the authenticated user's stubbed (test/example data, not live) GitHub marketplace subscriptions, useful for development or testing.

list-tag-protection-states-for-a-repository

Lists all active tag protection rules for a repository, defining patterns to prevent matching tags from being created or deleted; requires repository admin permissions.

list-team-members

Lists members of a specific team within an organization, including members of child teams.

list-team-projects

Lists GitHub projects accessible to a specific team within an organization.

list-team-repositories

Lists repositories accessible to a specific team within a GitHub organization.

list-teams

Lists teams for a specified GitHub organization.

list-teams-for-the-authenticated-user

Lists all teams across all organizations to which the authenticated user belongs, supporting pagination.

list-teams-that-are-assigned-to-an-organization-role

Lists teams assigned to a specific role within a GitHub organization.

list-the-people-a-user-follows

Lists GitHub users that a valid GitHub `username` is following, supporting pagination.

list-the-people-the-authenticated-user-follows

Lists people the authenticated user follows.

list-timeline-events-for-an-issue

Lists chronological events (e.

list-token-access-repositories

Lists repositories in an organization accessible by a specific fine-grained personal access token; this action is for GitHub apps.

list-user-projects

Retrieves a list of projects for a specified GitHub user, optionally filtering by state and supporting pagination; the username must be a valid GitHub handle.

list-users

Retrieves all GitHub users (individuals and organizations) in chronological order of their sign-up date.

list-users-blocked-by-an-organization

Lists users blocked by a specified GitHub organization.

list-users-blocked-by-the-authenticated-user

Lists users blocked by the authenticated user, returning an empty list if no users are blocked.

list-users-that-are-assigned-to-an-organization-role