GitHub

GitHub Integration for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with GitHub MCP or direct API to manage repositories, review pull requests, track issues, and automate code workflows through natural language.

BOOK A CALL GET STARTED FOR FREE

GitHub is a code hosting platform for version control and collaborative software development. It streamlines project management, code review, and team workflows in one place.

Supported Tools and Triggers

Tools

Triggers

Accept a repository invitationAccepts a pending repository invitation that has been issued to the authenticated user.

Add email for auth userAdds one or more email addresses (which will be initially unverified) to the authenticated user's github account; use this to associate new emails, noting an email verified for another account will error, while an existing email for the current user is accepted.

Add app access restrictionsReplaces github app access restrictions for an existing protected branch; requires a json array of app slugs in the request body, where apps must be installed and have 'contents' write permissions.

Add a repository collaboratorAdds 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 installationAdds 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 secretGrants 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 issueAdds 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 issueAdds labels (provided in the request body) to a repository issue; labels that do not already exist are created.

Add org runner labelsAdds 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 userAdds 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 permissionsGrants 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 permissionsSets or updates a team's permission level for a repository within an organization; the team must be a member of the organization.

Add project collaboratorAdds a specified github user as a collaborator to an existing organization project with a given permission level.

Add repo to org secret with selected accessAdds a repository to an existing organization-level github actions secret that is configured for 'selected' repository access.

Add selected repo to org secretGrants 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 labelsAdds and appends custom labels to a self-hosted repository runner, which must be registered and active.

Add selected repository to an organization secretAdds 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 variableGrants 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 userAdds 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 contextsAdds status check contexts (provided in the request body, e.

Add team access restrictionsOverwrites 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 restrictionsSets/replaces list of users allowed to push to a protected branch; usernames (e.

Add users to codespaces access for an organizationSets 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 requestApproves 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 teamAssigns 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 userAssigns a specific organization role to a user who is a member or an outside collaborator in a github organization, using a valid role id.

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

Block a userBlocks 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 organizationBlocks an existing github user from an existing organization, preventing their contributions, collaboration, and forking of the organization's repositories.

Cancel a GitHub Pages deploymentCancels an existing, ongoing or queued github pages deployment for a repository using its `pages deployment id`.

Cancel a workflow runCancels a workflow run in a github repository if it is in a cancellable state (e.

Check a tokenChecks 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 starredChecks 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 person is followed by authenticated userChecks 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 pull request mergedChecks if a specified github pull request has been merged, indicated by a 204 http status (merged) or 404 (not merged/found).

Check if repo starred by auth userUse 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 assignedVerifies 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 an issueChecks if a specified github user can be assigned to a given issue within a repository.

Check if a user follows another userChecks 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 collaboratorChecks 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 organizationChecks 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 userChecks 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 statusChecks if private vulnerability reporting is enabled for the specified repository.

Check team permissions for a projectChecks 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 repositoryChecks a team's permissions for a specific repository within an organization, including permissions inherited from parent teams.

Clear repository cache by keyDeletes 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 labelsRemoves all custom labels from a self-hosted runner for an organization; default labels (e.

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

Configure JIT runner for an orgGenerates 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 OIDC subject claim templateSets or updates the oidc subject claim customization template for an existing github organization by specifying which claims (e.

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

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

Create a check runCreates 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 suiteCreates 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 userCreates 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 requestCreates a github codespace for an open pull request in a codespaces-enabled repository, with options to customize its configuration.

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

Create a commitCreates a new commit in a github repository; the `tree` sha and any `parents` shas must already exist in the repository.

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

Create a commit statusSets a commit's status (e.

Create a custom organization roleCreates a custom role with defined permissions within a github organization.

Create a deploy keyCreates 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 deploymentCreates 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 policyCreates a deployment branch or tag policy for an existing environment in a github repository, using a ruby file.

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

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

Create a discussion commentCreates a new comment on an existing team discussion within a github organization.

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

Create a gistCreates a new gist on github with provided files, an optional description, and public/secret visibility.

Create a gist commentCreates a new comment on a specified github gist.

Create a GitHub App from a manifestUse 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 deploymentCreates 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 siteConfigures 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 labelCreates a new label in a specified github repository, provided the repository exists and the user has write permissions.

Create a milestoneCreates 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 repositoryCreates a repository autolink to automatically convert text references (e.

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

Create an issueCreates 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 commentCreates a new comment on an existing github issue or pull request within the specified repository.

Create an organization projectCreates a new classic project board within a specified github organization.

Create an organization repositoryCreates 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 variableCreates a new, uniquely named github actions variable for an organization, with configurable repository access visibility (all, private, or selected).

Create an organization webhookCreates a webhook for a github organization to deliver event notifications to a configured url.

Create a project cardCreates 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 columnCreates a new column in a github project (classic).

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

Create a referenceCreates a git reference (e.

Create a registration token for an organizationGenerates 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 repositoryGenerates a time-limited token required to register a new self-hosted runner with a specific repository.

Create a releaseCreates 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 organizationGenerates a token, valid for one hour, to authenticate removing a self-hosted runner from an organization.

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

Create a reply for a review commentPosts 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 eventTriggers 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 userCreates a new repository for the authenticated user, optionally within an organization if `team id` is specified.

Create a repository from an unpublished codespacePublishes the specified codespace to a new repository, using the codespace's current state as the initial commit.

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

Create a repository rulesetCreates 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 templateCreates 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 variableCreates a new, unencrypted variable in a repository for github actions workflows; fails if a variable with the same name already exists.

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

Create a review comment for a pull requestCreates 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 requestCreates 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 tokenExchanges 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 dependency snapshotCreates 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 objectCreates 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 repositoryCreates 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 teamCreates 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 forkCreates 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 treeCreates 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 projectCreates a new github project board for the authenticated user to organize and track issues, pull requests, and notes.

Create a workflow dispatch eventManually 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 protectionEnables commit signature protection for a specified branch, requiring all new commits to be signed.

Create a custom deployment protection rule on an environmentEnables 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 for repoGenerates 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 organizationCreates 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 environmentCreates 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 secretCreates 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 secretCreates 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 secretCreates 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 userCreates 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 organizationCreates 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 repository custom property valuesCreates 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 contentsCreates 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 valueCreates 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 commentCreates 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 issueCreates a reaction for a specified issue within a github repository.

Create reaction for an issue commentCreates a reaction for a specific comment on an issue within a github repository.

Create reaction for a pull request review commentAdds a specified reaction to a pull request review comment within a github repository.

Create reaction for a releaseCreates an emoji reaction for a specific, existing release in a github repository.

Create reaction for a team discussionCreates a reaction for a team discussion within a github organization.

Create reaction for a team discussion commentAdds a reaction to a team discussion comment, requiring the specified organization, team, discussion, and comment to exist.

Create or Update Organization Secret with LibSodiumCreates 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 templateRetrieves 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.

Get custom OIDC subject claim templateRetrieves 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.

Set custom OIDC subject claim templateSets 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 invitationDeclines a specific, pending repository invitation for the authenticated user, identified by its `invitation id`.

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

Delete a code scanning analysis from a repositoryDeletes 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 userDeletes a specific codespace owned by the authenticated user; this is a destructive action and the codespace must exist.

Delete a codespace from the organizationPermanently deletes a specific codespace belonging to a member of the specified organization.

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

Delete a commit comment reactionDeletes a reaction from a commit comment in a github repository.

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

Delete a deploy keyDeletes 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 deploymentPermanently deletes a specified *inactive* deployment from a repository.

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

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

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

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

Delete a fileDeletes 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 gistPermanently deletes an existing github gist, specified by its `gist id`; this action is destructive and cannot be undone.

Delete a gist commentDeletes a specific comment from a github gist using its `gist id` and `comment id`.

Delete a GitHub Pages siteDeletes the github pages site for the specified repository; completes without error if no site is currently enabled.

Delete a labelPermanently removes an existing label from a repository.

Delete a milestoneDeletes 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 authorizationRevokes a single, specific oauth access token for an oauth app, not all authorizations for the app.

Delete an app tokenRevokes an oauth access token for a github app, if the app exists and the token was issued to it.

Delete an artifactDeletes 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 repositoryDeletes a specific autolink reference (which automatically links external resource ids like jira-123 to urls) from the specified repository.

Delete authenticated user email addressSends 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 environmentDeletes an existing deployment environment from an existing repository.

Delete an environment secretDeletes 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 variableDeletes a named environment variable from a specified, existing environment within a github repository.

Delete an issue commentPermanently 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 reactionDeletes a reaction from an issue comment in a repository; the repository, comment, and reaction must exist.

Delete an issue reactionPermanently removes a specific reaction from an issue in a github repository.

Delete an organizationDeletes 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 secretPermanently deletes a secret from a github organization, making it inaccessible to github actions workflows or other tools.

Delete an organization variableDeletes a named github actions variable from a specified organization.

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

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

Delete a package for a userDeletes 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 userPermanently 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 userDeletes an existing package version associated with the authenticated user.

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

Delete a projectDeletes 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 cardDeletes a project card from a github 'project (classic)'; this operation is idempotent.

Delete a project columnDeletes a project column by its id from a github project (classic); this is a destructive operation.

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

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

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

Delete a release assetDeletes a specific release asset from a github repository; this action is idempotent.

Delete a release reactionDeletes a reaction from a github release, provided the repository, release, and reaction exist.

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

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

Delete a repository rulesetPermanently deletes a repository ruleset.

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

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

Delete a repository variableDeletes a named variable (e.

Delete a repository webhookDeletes a specific webhook from a repository.

Delete a review comment for a pull requestDeletes a specific pull request review comment.

Delete a secret for the authenticated userDeletes 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 organizationDeletes an existing and registered self-hosted runner from an organization, typically returning 204 no content on success.

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

Delete a tag protection state for a repositoryPermanently deletes a specific tag protection rule, identified by its id, from the given repository.

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

Delete a thread subscriptionCall 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 runDeletes a specific workflow run from a repository.

Delete branch protectionRemoves all protection rules from a specific branch in a github repository; the branch must currently have protection rules enabled.

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

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

Delete GitHub Actions cache by IDDeletes a specific github actions cache from a repository using its unique `cache id`.

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

Delete package version for a userPermanently and irreversibly deletes a specific version of a package owned by the specified user.

Delete pull request review protectionDisables 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 nameDeletes 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 userDeletes currently linked social media account urls from the authenticated user's github profile.

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

Delete team discussion reactionPermanently deletes a specific reaction from a team discussion within an organization.

Delete workflow run logsDeletes all logs for a specific workflow run in a github repository, provided the repository and run exist.

Disable a custom protection rule for an environmentDisables a specific, currently active custom deployment protection rule for an existing environment within a github repository.

Disable a workflowDisables 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 repositoryDisables private vulnerability reporting for an existing github repository, preventing direct private vulnerability reports to maintainers via github's interface for this repository.

DisablerepositoryactionsinorgDisables 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 requestDismisses a review on a pull request with a mandatory explanatory message.

Download an artifactDownloads a specific github repository artifact, returning a temporary url to its 'zip' archive, valid for one minute.

Download a repository tarballDownloads a repository's source code as a tarball (.

Download a repository archive ZIPDownloads 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 runDownloads 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 logsDownloads a zip archive of logs for a specific workflow run attempt.

Download workflow run logsDownloads logs for a specific github actions workflow run, typically archived as a zip file, if logs are available (e.

Enable a workflowReactivates a currently disabled github actions workflow within a repository using its numerical id.

Enable GitHub actions in selected repositoriesSets 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 repositoryEnables private vulnerability reporting for a repository, allowing security researchers to privately submit vulnerability reports to maintainers.

Enable repo for Github ActionsEnables github actions for a repository if the organization's actions permissions are set to allow for 'selected repositories'.

Encrypt and update dev secretCreates 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 secretCreates or updates an organization's github codespaces secret using an encrypted value and its corresponding public key id.

Encrypt org secrets using public keyRetrieves 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 userTriggers an export of a user's specified codespace, automatically stopping it if active, and returns its export status and download url.

Export an SBOM for a repositoryExports 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.

FetchpublickeyforsecretencryptionRetrieves the public key for an existing github organization, required for encrypting dependabot secrets.

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

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

Follow a userAllows 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 runForcefully cancels an existing github actions workflow run, bypassing normal cancellation conditions; requires write permissions to the repository.

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

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

Get a blobRetrieves 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 branchRetrieves detailed information for a specified branch within a github repository.

Get access restrictionsLists 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 runRetrieves detailed information for a specific check run within a github repository.

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

Get a classroomRetrieves details for a specific github classroom; the classroom id must correspond to an existing classroom.

Get a code of conductRetrieves the full details of a specific github code of conduct using its unique key.

Get a CodeQL database for a repositoryGets 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 alertRetrieves 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 repositoryRetrieves detailed information for a specific code scanning analysis on an accessible repository, identified by its `analysis id`.

Get a code scanning default setup configurationGets 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 userCall to retrieve detailed information for a `codespace name` belonging to the authenticated user, ensuring the codespace exists and is accessible.

Get a commitRetrieves 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 commentRetrieves the full details of a specific commit comment in a github repository, using its unique identifier.

Get a commit objectRetrieves 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 ruleRetrieves 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 organizationRetrieves the definition (schema) of a specific, existing custom property for an organization.

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

Get a deploy keyGets a specific deploy key, identified by its `key id`, for the github repository specified by `owner` and `repo`.

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

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

Get a deployment statusRetrieves a specific deployment status by its id for a given deployment within a github repository.

Get a diff of the dependencies between commitsGets 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 discussionFetches a specific discussion by its number from a team within an organization.

Get a discussion commentFetches a specific comment from a team discussion within a specific organization.

Get admin branch protectionChecks if repository administrators are subject to the branch protection rules on a specific branch.

Get a dns health check for github pagesRetrieves the dns health check status (e.

Get a gistFetches a specific github gist by its `gist id`, returning comprehensive details if the gist exists.

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

Get a gist revisionRetrieves a specific revision of a gist.

Get a GitHub Pages siteRetrieves information for a github pages site, which must be enabled for the repository.

Get a gitignore templateRetrieves a specific .

Get a job for a workflow runRetrieves 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 labelRetrieves a specific label by its name from a specified github repository.

Get a licenseCall this action to retrieve comprehensive details for a specific software license recognized by github, using its unique license key.

Get all API versionsRetrieves all officially supported, date-based (e.

Get all autolinks of a repositoryRetrieves all autolinks (e.

Get all codes of conductRetrieves all available codes of conduct from github, often used to select one for a repository.

Get all commonly used licensesRetrieves 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 activityRetrieves 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 organizationGets 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 repositoryGets 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 environmentLists 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 templatesRetrieves all available .

Get all organization roles for an organizationLists all custom organization roles for an existing github organization.

Get all repository rulesetsRetrieves all rulesets for a github repository, which define conditions and actions for repository interactions (e.

Get all repository topicsRetrieves all topics for a specified, existing, and accessible repository.

Get all requested reviewers for a pull requestGets all users and teams requested to review a specific pull request in a repository.

Get all status check contextsFetches 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 milestoneRetrieves detailed information for a specific milestone within a github repository by its number.

Get an appRetrieves publicly available information for an existing github app, identified by its unique url-friendly `app slug`.

Get an artifactGets a specific artifact for a repository by `artifact id`.

Get an assignmentRetrieves detailed information for a specific github classroom assignment if the authenticated user is an administrator of the classroom.

Get an autolink reference of a repositoryRetrieves 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 environmentGet an environment

Get an environment public keyRetrieves the public key for a specified github repository environment, used to encrypt secrets for github actions.

Get an environment secretGet an environment secret

Get an environment variableGet an environment variable

Get an issueGet an issue

Get an issue commentGet an issue comment

Get an issue eventGet an issue event

Get an organizationGet an organization

Get an organization public keyGet an organization public key

Get an organization roleRetrieves a specific github organization role by its id.

Get an organization secretGets an organization secret's metadata (e.

Get an organization variableRetrieves details (name, value, visibility, timestamps) of a specific, existing variable for an existing github organization.

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

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

Get a package for a userRetrieves metadata for a specific package owned by a github user, using package type, name, and username as identifiers.

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

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

Get a package version for a userRetrieves a specific public package version associated with a github user.

Get authenticated user package versionRetrieves 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 branchLists github apps with push access to a repository's protected branch.

Get a projectRetrieves detailed information for a specific github project using its unique `project id`.

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

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

Get a pull requestRetrieves a specific pull request from a github repository using its owner, repository name, and pull request number.

Get a referenceRetrieves a specific git reference (e.

Get a releaseGets a specific release from a github repository, provided the repository is accessible and the release exists.

Get a release assetGets metadata for a specific release asset in a github repository, including a `browser download url` for downloading the asset.

Get a release by tag nameGets a release from a github repository by its tag name; the repository and a release with this tag must already exist.

Get a repositoryRetrieves detailed information about an existing and accessible github repository.

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

Get a repository readmeFetches 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 directoryRetrieves the readme file from a specified directory within a github repository, optionally at a given commit, branch, or tag.

Get a repository rulesetRetrieves 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 suiteGets 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 secretGets metadata (name, creation/update timestamps) for an existing repository secret, excluding its encrypted value.

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

Get a repository variableGets a specific github actions variable by name from an accessible repository.

Get a repository webhookReturns the configuration of an existing webhook for a given repository.

Get a review comment for a pull requestRetrieves 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 requestRetrieves a specific review for a pull request using its owner, repository, pull request number, and review id.

Get a secret for the authenticated userRetrieves 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 organizationRetrieves detailed information about a specific self-hosted runner registered within a github organization.

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

Get assignment gradesRetrieves all grades for an existing github classroom assignment.

Get a tagRetrieves detailed information for a specific git tag object from a github repository, using the sha of the tag object itself.

Get a team by nameRetrieves a github team by its slug from a specific organization.

Get a threadRetrieves a specific github notification thread using its unique `thread id`.

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

Get a treeRetrieves 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 userRetrieves the public profile information for an existing github user, specified by their username.

Get a webhook configuration for an organizationRetrieves the configuration for a specific webhook associated with a github organization.

Get a webhook configuration for a repositoryReturns the configuration for an existing webhook on the specified repository.

Get a webhook delivery for an organization webhookReturns detailed information for a specific delivery attempt of a webhook configured for the specified github organization.

Get a workflowRetrieves detailed information for a specific github actions workflow in a repository, identified by either its numeric id or its filename.

Get a workflow runGets a specific workflow run by its id from a github repository.

Get a workflow run attemptRetrieves detailed information for a specific attempt of a workflow run in a github repository, including its status, conclusion, and timings.

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

Get commit authorsFetches commit authors identified during a repository import, used to map authors from an external vcs to github accounts.

Get commit signature protectionGets the commit signature protection status for a branch in a repository.

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

Get contextual information for a userGets 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 codespaceGet pre-flight data (e.

Get default workflow permissions for an organizationGets the default github token workflow permissions and settings for a github organization.

Get default workflow permissions for a repositoryGets 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 exportRetrieves detailed information about a specific export of a codespace.

Get emojisLists all emojis available for use on github, including custom and unicode emojis.

Get feedsFetches a list of available github feed urls for the authenticated user.

Get GitHub Actions cache usage for an organizationRetrieves 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 repositoryRetrieves the total count of active github actions caches and their combined size in bytes for a specified repository.

Get github actions permissions for an organizationGets the github actions permissions for a specified organization, detailing repository enablement and allowed actions policies.

Get GitHub Actions permissions for a repositoryGets the github actions permissions policy for a repository, including its enabled status and the scope of allowed actions.

Get github meta informationFetches github's publicly available metadata, useful for configuring network security policies or ip allow-listing.

Get github pages buildRetrieves detailed information about a specific github pages build for a repository, which must have github pages enabled.

Get information about a sarif uploadRetrieves 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 organizationRetrieves 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 repositoryRetrieves 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 public repositoriesRetrieves currently active interaction restrictions for the authenticated user's public repositories.

Get large filesLists 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 buildRetrieves 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 octocatFetches an ascii art representation of github's octocat, suitable for text-based displays.

Get allowed actions and workflows for an orgRetrieves the github actions permissions policy, including allowed actions and reusable workflows, for a specified organization.

Get org dev environment secret safelyRetrieves metadata for a specific secret available to an organization's github codespaces without exposing its encrypted value.

Get page viewsRetrieves 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 runRetrieves pending deployment environments for a specific workflow run that are awaiting approval due to protection rules.

Get project permission for a userRetrieves a collaborator's permission level (admin, write, read, or none) for an existing github project.

Get public key for secret encryptionRetrieves 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 userRetrieves the authenticated user's public github key, used to encrypt secrets for github codespaces.

Get pull request review protectionRetrieves 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 userRetrieves the authenticated user's current github api rate limit status, including usage and limits across different resource categories.

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

Get repository clonesRetrieves 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 contentRetrieves 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 userRetrieves 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 securelyRetrieves metadata for an existing dependabot secret in a repository, without exposing its encrypted value.

Get rules for a branchRetrieves all active rules for a specific branch in a github repository, excluding rules in 'evaluate' or 'disabled' status.

Get single org secret without decryptionRetrieves metadata (e.

Get status checks protectionRetrieves 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 userRetrieves a user's role and membership status within a specific team in an organization.

Get teams with access to the protected branchLists 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 userGets the profile information for the currently authenticated github user, including potentially private details based on user settings.

Get the combined status for a specific referenceRetrieves the aggregated commit status (e.

Get the hourly commit count for each dayRetrieves 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 activityFetches weekly commit totals and daily commit counts for the last 52 weeks for a specified github repository.

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

Get the license for a repositoryRetrieves 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 runRetrieves 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 deploymentRetrieves the status of a specific github pages deployment for a repository, which must have github pages enabled.

Get the weekly commit activityFetches 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 countRetrieves 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 githubRetrieves 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 pathsFetches the top 10 most viewed content paths for a repository from the last 14 days.

Get top referral sourcesFetches the top 10 websites that referred traffic to a repository within the last 14 days.

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

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

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

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

Get GitHub API rootRetrieves a map of all top-level github rest api resource urls and their templates.

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

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

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

List app installations for user tokenLists github app installations accessible to the authenticated user via their access token, including installation details, permissions, and repository access.

List artifacts for a repositoryLists github actions workflow artifacts for a specified repository, which must exist.

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

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

List assignments for a classroomLists all assignments for a given github classroom `classroom id`; the classroom must exist and be accessible.

List available machine types for a repositoryLists 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 branchesLists branches for an existing github repository, with an option to filter by protection status.

List branches for head commitLists 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 annotationsLists 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 referenceLists 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 suiteLists check runs for a specific check suite in a github repository, optionally filtering by check name or status.

List check suites for a git referenceLists 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 teamsLists the immediate child teams of a parent team within an organization.

List classroomsLists github classrooms to which the authenticated user has administrative access.

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

List CodeQL databases for a repositoryLists all codeql databases for a repository where codeql analysis has been previously run and completed.

List code scanning alerts for an organizationLists 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 repositoryLists 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 repositoryLists 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 organizationLists all github codespaces owned by a specified member of a given organization.

List codespaces for the authenticated userLists github codespaces for the authenticated user, optionally filtering by repository id and supporting pagination.

List codespaces for the organizationLists active/pending github codespaces for an existing organization; admins list all, members list their own.

List comments for a pull request reviewLists all comments for a specific review on a github pull request.

List commit commentsRetrieves all comments for a specific commit in a github repository, supporting pagination.

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

List commitsRetrieves 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 requestLists commits for a pull request; requires the repository and pull request to exist and be accessible, and supports pagination.

List commit statuses for a referenceLists 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 repositoriesLists custom property values for repositories in a specified, existing organization, optionally filtered by a repository query.

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

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

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

List deployment branch policiesLists all deployment branch policies for a specified environment in a github repository.

List deploymentsLists deployments for a specified repository; repository must exist.

List deployment statusesLists all statuses for a given deployment in a repository.

List discussion commentsLists all comments for a specific team discussion within an organization.

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

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

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

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

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

List environment variablesLists 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 userLists 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 userLists 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 userLists followers for a specified, existing github user.

List followers of the authenticated userLists users following the authenticated github user, returning an empty list if the user has no followers.

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

List gist commentsLists comments for a specified github gist.

List gist commitsLists all commits for a specified gist.

List gist forksLists all forks for a given github gist id.

List gists for a userLists public gists for a specified github user.

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

List github actions caches for a repositoryLists 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 buildsLists github pages builds for a repository; github pages must be enabled on the repository for builds to be listed.

List global security advisoriesLists github's global security advisories, filterable by various attributes including id, type, ecosystem, severity, and dates.

List installation requests for the authenticated appLists pending installation requests made by users or organizations for the authenticated github app.

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

List issue commentsLists comments for a specified issue in a github repository.

List issue comments for a repositoryLists issue comments, including those on pull requests, for an accessible repository.

List issue eventsRetrieves a list of all events for a specific issue within a github repository.

List issue events for a repositoryLists all issue events (e.

List issues for userLists 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 runLists jobs for a specific workflow run in a github repository.

List jobs for a workflow run attemptLists jobs, including details like id, status, and steps, for a specific attempt of a github actions workflow run.

List labels for an issueLists all labels for a specified issue in a github repository.

List labels for a repositoryRetrieves all labels for a specified, existing github repository.

List labels for a self-hosted runner for an organizationLists 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 repositoryLists all labels assigned to a specific self-hosted runner registered with the given repository.

List labels for issues in a milestoneLists all labels for issues within a specific milestone in a repository.

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

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

List milestonesLists 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 userLists notifications for the authenticated user, sorted by most recent update, with filtering and pagination options.

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

List organization membersLists public and concealed members of a github organization; viewing concealed members requires authenticated user to be an organization member.

List organization projectsLists projects for a specified github organization, optionally filtering by state and supporting pagination.

List organization repositoriesRetrieves a list of repositories for a specified github organization, allowing filtering by type and sorting.

List organizationsLists github organizations for the authenticated user, sorted by id in ascending order.

List organization secretsLists github actions secrets available for a specified organization.

List organizations for a userLists public organizations for a specified github user; the `username` must be a valid github handle.

List organizations for the authenticated userLists organizations the authenticated github user is a member of, returning details for each organization.

List organization variablesLists all github actions variables for a specified organization.

List organization webhooksLists all webhooks for a specified github organization; the organization must exist.

List organization fine-grained permissionsRetrieves all fine-grained permissions for a specified github organization, essential for creating or updating custom roles.

List organization issues assigned to the authenticated userLists 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 secretsLists all codespaces secrets available for a specified organization, which must exist.

List package versions for an organization packageLists all versions for a specified package, if it exists and is owned by the given github organization.

List organization repositories with Github Actions enabledLists 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 tokensLists 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 tokensRetrieves a list of an organization's fine-grained personal access token requests (pending, approved, or denied), with options for filtering and sorting.

List organization Dependabot secrets without valuesLists 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 organizationLists outside collaborators for a github organization, with options to filter (e.

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

List packages for an organizationLists github packages for an organization, noting specific interpretations for package type and visibility parameters.

List packages for a userLists packages for a specified github user, filterable by package type and visibility.

List packages for the authenticated user's namespaceLists packages of a specific type and visibility within the authenticated user's namespace on github.

List package versions for a package owned by a userLists all versions of a public package owned by a specific github user, identified by package type, package name, and username.

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

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

List project collaboratorsFetches a list of collaborators for a specified, existing github project.

List project columnsLists all of a github project's columns (e.

List public email addresses for the authenticated userLists the public email addresses for the authenticated user.

List public eventsLists public github events, which may be delayed by up to 5 minutes, with support for pagination.

List public events for a network of repositoriesRetrieves 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 userRetrieves a list of public events for a specified github user, in reverse chronological order.

List public events received by a userLists public events for a specified github user (e.

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

List public keys for a userLists the verified public ssh keys for a specified github user.

List public organization eventsLists public events for a specified github organization, which must exist.

List public organization membersLists users who have publicly declared their membership in a specified, existing github organization.

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

List pull requestsLists pull requests for a specified github repository with ai-friendly filtering.

List pull requests associated with a commitLists 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 filesLists all files (including additions, modifications, and removals) associated with a specific pull request in a github repository.

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

List reactions for an issueLists reactions for a specific, existing issue within an accessible github repository, optionally filtering by content type.

List reactions for an issue commentLists reactions for a specific issue comment in a github repository, optionally filtering by content type.

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

List reactions for a releaseLists all reactions, or optionally filters reactions by a specific content type, for a given github release.

List reactions for a team discussionLists reactions for an existing team discussion within an organization.

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

List release assetsLists assets (e.

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

List repo access by tokenLists 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 for authenticated userLists codespaces the authenticated user can access within a specified, existing repository.

List repo dev container configs for userLists the `devcontainer.

List repo secrets without valuesLists all codespaces secrets available in a specific repository, without their encrypted values.

List repos accessible to app installationLists repositories an app installation can access; 'total count' in response is zero if none are accessible.

List repositories accessible to the user access tokenLists repositories accessible to the authenticated user through a specific github app installation (identified by `installation id`).

List repositories for a userLists public repositories for a specified github user, who must have an existing account.

List repositories for the authenticated userLists 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 userLists repositories a valid and existing github user has starred.

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

List repositories watched by a userLists repositories a given github user is watching; the username must be a valid and existing github user handle.

List repositories watched by the authenticated userLists repositories the authenticated user is watching (subscribed to for notifications).

List repository activitiesLists activities for a github repository, ensuring the repository exists and is accessible.

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

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

List repository eventsLists chronological events (e.

List repository invitationsRetrieves all pending (unaccepted or undeclined) collaboration invitations for a specified github repository.

List authenticated user's repository invitationsLists all pending repository invitations for the authenticated user.

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

List repository languagesLists the programming languages used in a github repository, returning a byte count for each language.

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

List repository organization secretsLists 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 variablesLists organization variables accessible to a specific repository; the repository must exist.

List repository projectsLists projects associated with a specific repository.

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

List repository secretsLists metadata for all secrets in a github repository, excluding their encrypted values.

List repository secrets without decryptingLists metadata (e.

List repository tagsLists tags for a specified github repository.

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

List repository variablesLists plain text key-value variables for github actions workflows within a specific, accessible repository.

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

List repository workflowsLists all github actions workflows for a specified repository, which must exist and be accessible.

List repos with ghactions cache usageRetrieves a paginated list of github actions cache usage statistics for repositories within an existing github organization.

List review comments in a repositoryLists all review comments on all pull requests within a specified repository.

List review comments on a pull requestLists all review comments on a specific pull request within a github repository.

List reviews for a pull requestLists submitted reviews chronologically for a specific pull request within a github repository.

List runner applications for an organizationLists downloadable github actions runner application binaries, used for setting up self-hosted runners, for an existing github organization.

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

List secrets for the authenticated userLists all codespaces secrets accessible to the authenticated user for use within github codespaces.

List selected repos for secret accessLists repositories within a specified organization that have been granted access to a particular dependabot secret.

List selected repositories for an organization secretLists 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 variableLists 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 secretLists 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 organizationLists 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 repositoryLists all self-hosted runners configured for a repository.

List social accounts for a userLists social media accounts publicly linked to an existing github user's profile.

List social accounts for the authenticated userLists all social media accounts linked to the authenticated user's github profile.

List stargazersLists users who have starred the specified github repository, which must exist.

List starred gistsRetrieves a list of gists starred by the authenticated user.

List subscriptions for the authenticated userLists the authenticated user's active github marketplace subscriptions.

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

List tag protection states for a repositoryLists 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 membersLists members of a specific team within an organization, including members of child teams.

List team projectsLists github projects accessible to a specific team within an organization.

List team repositoriesLists repositories accessible to a specific team within a github organization.

List teamsLists teams for a specified github organization.

List teams for the authenticated userLists all teams across all organizations to which the authenticated user belongs, supporting pagination.

List teams assigned to an organization roleLists teams assigned to a specific role within a github organization.

List the people a user followsLists github users that a valid github `username` is following, supporting pagination.

List people the authenticated user followsLists people the authenticated user follows.

List timeline events for an issueLists chronological events (e.

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

List user projectsRetrieves 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 usersRetrieves all github users (individuals and organizations) in chronological order of their sign-up date.

List users blocked by an organizationLists users blocked by a specified github organization.

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

List users assigned org roleLists users assigned to a specific role within a github organization.

List watchersRetrieves a list of users watching a specific repository; the repository must be accessible to the authenticated user.

List workflow run artifactsLists artifacts (e.

List workflow runs for a repositoryLists workflow runs for a repository, allowing filtering by actor, branch, event, status, creation date, check suite id, or head sha; the repository must exist and be accessible.

List workflow runs for a workflowLists runs for a specified, existing workflow (identified by id or filename like `main.

Lock an issueLocks an existing github issue's conversation, preventing further comments; an optional reason can be specified.

Manage access control for organization codespacesSets the codespaces access control policy for a github organization, determining which members can use them.

Manage custom properties for org reposCreates or updates values for an organization's predefined custom properties across multiple repositories (up to 30).

Manage secrets in selected repositories with proper accessLists repositories within an organization that have been explicitly granted access to a specific organization secret.

Map a commit authorUpdates git author information (name and/or email) for an `author id` obtained during a repository import, to correctly attribute commits.

Mark a thread as doneMarks the github notification thread (identified by `thread id`) as done or read for the authenticated user, effectively archiving it.

Mark a thread as readMarks an existing github notification thread, identified by its `thread id`, as read.

Mark notifications as readMarks notifications as read or unread, optionally for those updated at or before a `last read at` timestamp.

Mark repository notifications as readMarks notifications in a repository as read; if 'last read at' is specified, notifications updated after this timestamp are not marked as read.

Merge a branchMerges a head branch or commit sha into a base branch in a repository; fails if there are merge conflicts requiring manual resolution.

Merge a pull requestMerges an open and mergeable pull request in a repository, optionally specifying merge commit details, a merge method, and a required head sha for safety.

Move a project cardMoves a project card to a specified position, optionally into a new column.

Move a project columnMoves a column within a github project (classic) to a new position; `position` can be 'first', 'last', or 'after:', where `target column id` must reference an existing column in the same project.

Ping an organization webhookSends a 'ping' event to a specified, existing organization webhook to test its configuration and ensure it correctly receives events.

Ping a repository webhookPings an existing webhook on a repository to test its configuration and reachability by github.

Privately report a security vulnerabilityPrivately reports a security vulnerability for a repository; specify either `severity` or `cvss vector string`, but not both.

Redeliver a delivery for an organization webhookRedelivers a specific webhook delivery for a webhook within an organization, to resend an event that previously failed or was not processed.

Redeliver a delivery for a repository webhookRedelivers a specific, previously made webhook delivery (`delivery id`) for a repository's webhook (`hook id`).

Remove a custom property for an organizationDeletes a custom property, specified by `custom property name`, from an existing organization (`org`) for which the property is currently defined, preventing its future assignment to repositories.

Remove a label from an issueRemoves a label currently applied to a specific issue in a repository.

Remove all labels from an issueRemoves all labels from a specified issue in a github repository; this operation is idempotent.

Remove all organization roles for a teamRevokes all organization roles for a team in an organization; this is destructive and succeeds even if the team initially has no roles.

Remove all organization roles for a userRevokes all assigned organization-level roles from a specified user (who must be a member of the organization) within a github organization, without removing the user from the organization or affecting repository-specific roles.

Remove an organization memberRemoves a user, who must currently be a member, from a github organization, revoking their membership and access rights.

Remove an organization role from a teamRevokes an organization role that a team currently possesses within an organization.

Remove an organization role from a userRemoves a custom organization role from a user within a github organization, provided the organization exists, the user is a member, and the role id corresponds to a valid custom role in that organization.

Remove app access restrictionsRemoves all github app access restrictions from a protected branch in a repository; the branch must have protection rules configured, and this action does not alter user or team restrictions.

Remove a project from a teamRemoves a project from a team within an organization; this action requires the project to be currently associated with the team.

Remove a repository collaboratorRemoves a collaborator from a specified github repository, provided the repository exists and the user is an existing collaborator.

Remove a repository from an app installationRemoves a repository from a github app installation for the authenticated user, given a valid `installation id` and the `repository id` of a repository currently linked to that installation; this operation is idempotent.

Remove a repository from a teamDisassociates a repository from a team; team members may lose access permissions, but the repository and team are not deleted.

Remove a selected repository from a user secretRemoves a selected repository's access to a user's codespaces secret; the secret must exist and the repository must have previously been granted access.

Remove assignees from an issueRemoves specified assignees from a github issue; requires push access, and invalid removal attempts are silently ignored.

Remove custom label from repo runnerRemoves a custom label from a repository's self-hosted runner; this operation is idempotent.

Remove custom label from self hosted runnerRemoves a currently assigned custom label (`name`) from a self-hosted runner (`runner id`) in an organization (`org`).

Remove custom labels from self hosted repo runnerRemoves all custom labels from a self-hosted runner registered at the repository level, leaving only its default labels and any labels inherited from its runner group or organization.

Remove interaction restrictions for an organizationRemoves all interaction restrictions from public repositories in the specified github organization, allowing all users to resume interactions.

Remove interaction restrictions for a repositoryRemoves all interaction restrictions for a repository, enabling all users to comment, open issues, and create pull requests by lifting any existing temporary interaction limits.

Remove user public repo interaction restrictionsRemoves all interaction restrictions (limitations on comments, issues, or pull requests) from all public repositories owned by the authenticated user.

Remove org dev env secret by nameDeletes a github codespaces secret from an organization by its name; this operation is idempotent.

Remove org secret by namePermanently removes a specific dependabot secret, by its `secret name`, from the github `org`, making it unavailable to dependabot for that organization.

Remove outside collaborator from an organizationRemoves a user, who must be an outside collaborator, from the specified github organization, revoking their access to all its repositories.

Remove public org membershipMakes an authenticated user's public membership in an organization private (without removing them from the organization); the user must currently be a public member of that organization.

RemoverepofromorgdevenvsecretRemoves a repository's access to an organization-level codespaces secret, if it was previously granted.

Remove selected repo from org secretRevokes a specific repository's access to an organization-level dependabot secret, applicable only when the secret has 'selected' visibility and the specified repository currently has access.

Remove requested reviewers from a pull requestRemoves currently assigned user logins and/or team slugs from a github pull request's list of requested reviewers.

Remove selected repository from an organization secretRemoves a specific repository's access to an organization-level secret; the repository must have been previously granted access to this secret.

Remove selected repository from an organization variableRemoves a repository's access to an organization variable, if the variable's visibility is 'selected' and the repository is in its access list.

Remove status check contextsRemoves specified status check contexts (passed in the request body as an array of strings) from a protected branch in a repository.

Remove status check protectionRemoves status check protection from a branch, disabling required status checks for merging pull requests; will only have an effect if status check protection is currently configured on the branch.

Remove team access restrictionsRemoves all team-based access restrictions from a specified protected branch; the branch must be protected and have existing team restrictions for this action to change settings.

Remove team membership for a userRemoves a user from a specific team within an organization; this action fails if team synchronization with an identity provider (idp) is enabled, and may delete the team if the user is its last member and the team is not nested.

Remove user access restrictionsRemoves active user-level access restrictions from a specified protected branch, enabling users with repository write access to push or merge if no other team or app restrictions apply.

Remove user as a collaboratorRemoves a user as a collaborator from an organization project; the user must already be a collaborator on the specified project.

Remove users from codespaces access for an organizationRemoves selected users from github codespaces billing access for an existing organization.

Rename a branchRenames an existing branch in a github repository; the new name must be unique and adhere to github's naming conventions, and the current branch name cannot contain wildcard characters.

Render a markdown documentRenders markdown to html; for 'gfm' mode, provide 'context' (owner/repo) to correctly link issues, pull requests, and user mentions.

Replace all repository topicsReplaces all topics of a repository.

Replace org secret visibility to selectedSets an existing dependabot organization secret's visibility to 'selected' and replaces the full list of repositories that can access it with the ids provided.

Replace repository access for an org Codespaces secretReplaces the list of repositories that can access an existing organization-level codespaces secret with the provided valid repository ids owned by the organization.

Request a github pages buildManually triggers a github pages build for a repository if github pages is enabled, useful for deployments not automatically built or for retrying failed builds.

Request reviewers for a pull requestRequests user and/or team reviewers for an open pull request in a repository; requires `owner`, `repo`, `pull number`, and at least one of `reviewers` or `team reviewers`.

Rerequest a check runTriggers a re-run of a specific check run in a github repository, which resets its status to 'queued', clears its conclusion, and triggers the `check run` webhook with `rerequested`.

Rerequest a check suiteTriggers a new run of an existing check suite within a repository, useful for re-running checks without new code.

Re-run a job from a workflow runRe-runs a specific job and any dependent jobs from a github actions workflow run in the specified repository, optionally enabling debug logging.

Rerun a workflowRe-runs a specific github actions workflow run identified by its owner, repository, and run id, optionally enabling debug logging.

Rerun failed jobs from a workflow runRe-runs all failed jobs and their dependent jobs from a specified workflow run if the run contains previously failed jobs.

Reset a tokenInvalidates the provided oauth `access token` and generates a new one for the github oauth app identified by `client id`, used for token compromise or security rotation.

Restore a package for an organizationRestores a package in an organization, provided it was deleted within the last 30 days.

Restore a package for a userRestores a user-owned package previously deleted from github packages, if restorable under github's data retention policy (typically within 30 days of deletion).

Restore a package for the authenticated userRestores a package deleted by the authenticated user within the last 30 days, if its namespace and version are still available.

Restore a package version for the authenticated userRestores a package version that was deleted by the authenticated user within the last 30 days.

Restore package version for an organizationRestores a package version for an organization, provided it was deleted within the last 30 days.

Restore package version for a userRestores a specific, user-owned package version if it was deleted within the last 30 days and its original namespace and version name are still available.

Retrieve repo public key for encryptionGets a repository's public key, used to encrypt secrets for dependabot.

Review access with personal tokenApproves or denies a pending fine-grained personal access token request for organization resources; must be performed by a github app.

Review Custom Deployment Rules For Workflow RunApproves or rejects pending custom deployment protection rules for a workflow run by posting a review with `environment name` (str), `state` (str: 'approved'/'rejected'), and optional `comment` (str) in the request body, targeting a run with rules awaiting review.

Review pending deployments for a workflow runApproves or rejects pending deployments for a specific workflow run that are in a 'waiting' state within specified, configured environments.

Review resource requests with fine grained tokensApproves or denies fine-grained personal access token requests for an organization; any specified `pat request ids` must refer to currently pending requests.

Revoke an installation access tokenRevokes the github app's current installation access token, immediately invalidating it for api authentication.

Search codeSearches code file contents and paths on the default branch of github repositories using a query string; searches only files under 384kb, returns max 1000 results by best match, and is optimized for precision.

Search commitsFinds commits on github using a query string (q) supporting keywords and qualifiers, with options for sorting and pagination.

Search issues and pull requestsSearches github for issues and pull requests.

Search labelsSearches for labels within a github repository by keywords in their names or descriptions.

Search repositoriesSearches github repositories using a flexible query (keywords, qualifiers) with sorting, ordering, and pagination.

Search topicsFinds topics on github using keywords and qualifiers with github's search syntax, supporting pagination.

Search usersSearches for users on github by criteria like username, email, location, followers, or repository associations, using a flexible query string `q`.

Set admin branch protectionEnables administrator enforcement on a branch, making existing protection rules also apply to administrators; branch protection rules must already be configured.

Set app access restrictionsReplaces the list of github apps permitted to push to a protected branch; the branch must already be protected and apps must be installed with 'contents' permission.

Set a repository subscriptionSets the authenticated user's notification subscription for a repository.

Set a thread subscriptionSets whether a github notification thread is ignored (muted) or unignored (unmuted), for a `thread id` that must identify an existing notification thread.

Set default workflow permissions for an organizationUpdates an organization's default github token permissions for workflows and whether github actions can approve pull requests; note that allowing actions to approve pull requests (`can approve pull request reviews: true`) is a security risk.

Set default workflow permissions for a repositorySets the default permissions for the github token within a repository and configures whether github actions can approve pull requests.

Set GitHub Actions permissions for an organizationSets the github actions permissions policy for an organization, specifying which repositories can run actions and which actions/workflows are allowed; if 'selected' is chosen for either, manage the specific lists via other endpoints.

Set github actions permissions for a repositorySets github actions permissions for a repository, enabling/disabling actions and defining the policy for allowed actions and reusable workflows.

Set interaction restrictions for an organizationLimits interactions (comments, new issues, prs) in an organization's public repositories by user type and duration, typically to mitigate high traffic or unwanted activity.

Set interaction restrictions for a repositoryTemporarily limits which github users (e.

Set interaction restrictions for your public repositoriesSets or updates temporary interaction restrictions for all public repositories owned by the authenticated user, overriding any repository-specific limits.

Set labels for an issueReplaces all existing labels on a github issue with a new set of labels.

Set allowed actions and workflows for an organizationSets the github actions permissions for an existing organization, specifying allowed github-owned actions, verified creator actions, and action/workflow patterns from public repositories.

Set custom labels for a self-hosted runner for an organizationSets the custom labels for a self-hosted runner in an organization; this operation does not affect default system-assigned labels (e.

Set primary email visibilitySets the visibility ('public' or 'private') of the authenticated user's primary email address on github, if one is configured.

Set repo allowed actionsSets allowed github actions and reusable workflows for a repository, managing permissions for github-owned, verified creator, or specific pattern-matched actions/workflows (note: `patterns allowed` applies only to public repositories).

Set selected repositories for an organization secretReplaces the list of repositories that can access an organization secret; only effective if the secret's visibility is 'selected'.

Set selected repositories for an organization variableReplaces the list of repositories that can access an organization-level variable; the variable's visibility must be 'selected'.

Set selected repositories for a user secretDefines the list of repositories permitted to access a specific codespaces secret for the authenticated user.

Set status check contextsReplaces required status check contexts for a protected branch, requiring admin permissions; an empty `contexts` array removes all checks.

Set team access restrictionsSets team push access for a protected branch by replacing all current teams with a new list of valid team slugs (provided in the request body); an empty list of slugs removes all team restrictions.

Set user access restrictionsReplaces the list of users with push access to a protected branch using a request body (not in this schema) containing an array of github usernames; this enables branch protection if not already active.

Set workflow access level outside repositorySets the access level for workflows outside a repository to use actions and reusable workflows within that repository.

Star a gistStars a github gist identified by `gist id`; this action is idempotent and returns a 204 no content status upon success, even if the gist is already starred.

Star a repository for the authenticated userStars an existing and accessible repository for the authenticated user; this action is idempotent and succeeds even if the repository is already starred.

Start a codespace for the authenticated userInitiates the startup process for an existing github codespace (identified by `codespace name`) if it's in a startable state like 'available' or 'stopped'.

Stop a codespace for an organization userStops a codespace, which must be currently running, for a specified member of an organization.

Stop a codespace for the authenticated userStops a running or available codespace for the authenticated user, pausing its execution and billing.

Submit a review for a pull requestFinalizes a pending pull request review (identified by `review id`) with a required `event` (approve, request changes, comment) and an optional `body`.

Sync a fork branch with the upstream repositorySynchronizes a branch in a forked github repository with its upstream counterpart, assuming the repository is a fork, the branch exists, an upstream is configured, and the merge is conflict-free.

Test the push repository webhookTriggers a simulated push event to test a repository's push webhook; a test event is only delivered if the webhook is subscribed to 'push' events, otherwise, it returns 204 no content without sending a post.

Transfer a repositoryInitiates a repository transfer to a new owner (who must accept the request); if the new owner is an organization, it must be configured to allow transfers.

Unblock a userUnblocks a github user, provided they are currently blocked by the authenticated user.

Unblock a user from an organizationUnblocks a user from an organization, allowing renewed interaction with its resources, provided the user is currently blocked (otherwise, a 404 error may occur).

Unfollow a userUnfollows an existing github user; this action is idempotent, succeeding even if the authenticated user is not currently following them.

Unlock an issueUnlocks a currently locked github issue in the specified repository, allowing new comments and interactions.

Unlock an organization repositoryUnlocks an organization repository previously locked by a github migration.

Unlock a user repositoryUnlocks a repository (`repo name`) that was locked as part of a user migration (`migration id`), making it usable or deletable; this action requires the repository to be currently locked.

Unstar a gistRemoves a star from the specified gist; the action is idempotent and will not error if the gist was not previously starred by the user.

Unstar a repositoryRemoves the authenticated user's star from a specified repository, which must already be starred by the user.

Update a check runUpdates an existing check run for a specific commit in a repository, allowing modifications to its status, conclusion, output, and other details.

Update a code scanning alertUpdates a specific code scanning alert in a github repository, primarily to change its state (e.

Update a code scanning default setup configurationUpdates the default setup configuration for code scanning in a repository; github advanced security must be enabled for the repository.

Update a codespace for the authenticated userUpdates an existing github codespace's machine type, display name, or recent folders for the authenticated user; machine type changes take effect on the next start.

Update a commit commentChanges the body of an existing commit comment.

Update a custom organization roleUpdates an existing custom role in an organization by modifying its name, description, or permissions; at least one of these fields must be provided.

Update a deployment branch policyUpdates the name pattern of an existing deployment branch policy for a specific environment in a repository.

Update a discussionUpdates the title and/or body of a specific team discussion within an organization.

Update a discussion commentUpdates the body of a comment in a team's discussion within an organization.

Update a gistUpdates a gist's description, and/or its files (including content, filename changes, or deletion).

Update a gist commentUpdates an existing comment on a specified gist.

Update a labelUpdates an existing label's name, color, or description within a specified repository.

Update a milestoneUpdates a milestone in a repository, identified by `owner`, `repo`, and `milestone number`, by allowing modification of its `title`, `state`, `description`, or `due on`; at least one of these four attributes must be provided to perform an update.

Update an environment variableUpdates an existing environment variable's name and/or value in a specific github repository environment; requires providing either a new name or a new value.

Update an existing project cardUpdates an existing project card's note and/or archived status, identified by its `card id`.

Update an existing project columnUpdates the name of an existing column, identified by `column id`, in a github project (classic).

Update an issueUpdates an existing github issue's title, body, state, milestone, labels, or assignees; `state reason` is only processed if `state` also changes, and use `null` or `[]` to clear applicable fields.

Update an issue commentUpdates an existing comment on an issue or pull request within a specified repository.

Update an organizationUpdates an organization's settings; changing security-related fields requires admin, owner, or security manager permissions.

Update an organization variableUpdates an existing github actions organization variable's name, value, or visibility (`all`, `private`, `selected`), requiring `selected repository ids` with valid repository ids if visibility is `selected`.

Update an organization webhookUpdates the configuration (url, content type, secret, ssl verification), subscribed events, active status, or name of an existing webhook for a specified organization.

Update a projectUpdates an existing github project's attributes if the github projects feature is enabled and at least one modifiable field is provided.

Update a pull requestUpdates an existing pull request, allowing changes to attributes like title, body, state, base branch, and maintainer modification settings.

Update a pull request branchUpdates an open pull request's head branch by merging the latest changes from its base branch, if mergeable and repository merging is enabled; operates asynchronously.

Update a referenceUpdates a git reference (e.

Update a releaseUpdates an existing release in a github repository, allowing modification of its attributes; if linking a discussion, the `discussion category name` must refer to an existing category in the repository.

Update a release assetUpdates the name, label, or state of a release asset in a github repository, requiring at least one of these properties to be provided for modification.

Update a repositoryUpdates settings for an existing github repository, such as name, description, visibility, merge strategies, and security configurations.

Update a repository invitationUpdates an active repository invitation to modify the invited user's permissions; the specified repository and invitation must exist.

Update a repository rulesetUpdates an existing repository ruleset, identified by `ruleset id` for a given repository, allowing partial updates to its configuration such as name, target, enforcement, bypass actors, conditions, and rules.

Update a repository variableUpdates the name and/or value of an existing github actions variable in a repository.

Update a repository webhookUpdates the url, content type, secret, ssl verification, events, or active status for an existing repository webhook, specified by `owner`, `repo`, and `hook id`.

Update a review comment for a pull requestUpdates the body of an existing review comment on a pull request.

Update a review for a pull requestUpdates the body text of an existing pull request review.

Update a teamUpdates a team's settings (e.

Update a webhook configuration for an organizationUpdates the configuration (url, content type, secret, ssl verification) for an existing webhook within a specified organization.

Update a webhook configuration for a repositoryUpdates the configuration (e.

Update branch protectionUpdates the protection settings for an existing branch in a repository, which must not contain wildcard characters.

Update git lfs preferenceSets the git large file storage (lfs) preference for a repository, typically before initiating a source import.

Update information about a github pages siteUpdates the configuration for a github pages site (e.

Update pull request review protectionUpdates pull request review protection settings (e.

Update repository preferences for check suitesUpdates repository preferences for automatic check suite creation on code pushes, allowing configuration for specific github apps that must be installed on the repository with `checks:write` permission.

Update resource access with tokensRevokes organization access for the personal access tokens identified by `pat ids`; this action must be performed by a github app, and `pat ids` must be valid and associated with the organization.

Update status check protectionUpdates required status checks for a branch, optionally requiring it to be up-to-date before merging.

Update the authenticated userUpdates the authenticated user's github profile; a new public email must be verified, and existing private emails remain private even if specified.

Update token org accessRevokes a fine-grained personal access token's access to an organization, usable only by github apps when the token has existing access to that organization.

Upload an analysis as sarif dataUploads a gzipped and base64 encoded sarif file to a github repository for a specific commit and reference; use `checkout uri` if sarif paths are absolute.

Verify dev container permissions acceptedVerifies if the authenticated user has accepted permissions for a specific devcontainer configuration in a repository, typically to ensure awareness before a codespace is created or used.

Connect GitHub MCP Tool with your Agent

Python

TypeScript

Install Composio

python

pip install composio claude-agent-sdk

Install the Composio SDK and Claude Agent SDK

Create Tool Router Session

python

from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url

Initialize the Composio client and create a Tool Router session

Connect to AI Agent

python

import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to GitHub tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('List all open issues assigned to me')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())

Use the MCP server with your AI agent

Connect GitHub API Tool with your Agent

Python

TypeScript

Install Composio

python

pip install composio_openai

Install the Composio SDK

Initialize Composio and Create Tool Router Session

python

from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')

Import and initialize Composio client, then create a Tool Router session

Execute GitHub Tools via Tool Router with Your Agent

python

tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'List all open issues assigned to me'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)

Get tools from Tool Router session and execute GitHub actions with your Agent

Why Use Composio?

AI Native GitHub Integration

Supports both GitHub MCP and direct API based integrations
Structured, LLM-friendly schemas for reliable tool execution
Rich coverage for reading, writing, and querying your GitHub data

Managed Auth

Built-in OAuth handling with automatic token refresh and rotation
Central place to manage, scope, and revoke GitHub access
Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

Tools are tuned using real error and success rates to improve reliability over time
Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

Fine-grained RBAC so you control which agents and users can access GitHub
Scoped, least privilege access to GitHub resources
Full audit trail of agent actions to support review and compliance

Use GitHub with any AI Agent Framework

Choose a Framework you want to connect GitHub with

OpenAI Agents SDK

Use GitHub MCP with OpenAI Agents SDK

Claude Agents SDK

Use GitHub MCP with Claude Agents SDK

Google ADK

Use GitHub MCP with Google ADK

Langchain

Use GitHub MCP with Langchain

AI SDK

Use GitHub MCP with AI SDK

Mastra AI

Use GitHub MCP with Mastra AI

LlamaIndex

Use GitHub MCP with LlamaIndex

CrewAI

Use GitHub MCP with CrewAI

Pydantic AI

Use GitHub MCP with Pydantic AI

Autogen

Use GitHub MCP with Autogen

Explore Other Toolkits

Algolia

API KeyOAuth2

Algolia is a hosted search API that powers lightning-fast, relevant search experiences for web and mobile apps. It helps developers deliver instant, typo-tolerant, and scalable search without complex infrastructure.

Apiverve

API Key

Apiverve delivers a suite of powerful APIs that simplify integration for developers. It's designed for reliability and scalability so you can build faster, smarter applications without the integration headache.

Appcircle

API Key

Appcircle is an enterprise-grade mobile CI/CD platform for building, testing, and publishing mobile apps. It streamlines mobile DevOps so teams ship faster and with more confidence.

TOOLKIT MARKETPLACE

Frequently Asked Questions

Do I need my own developer credentials to use GitHub with Composio?

No, you can get started immediately using Composio's built-in GitHub app. For production, we recommend configuring your own OAuth credentials.

Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Used by agents from

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Book a call↗Get started for free

Harsha GaddipatiCo-founder, Slashy

Karan skipped his own birthday party to fix our critical issue. It was 10 pm and he diverted his Waymo to help us instead. This really sets the bar, shows you the commitment you need to have when users rely on your software.

Abhi AryaCo-founder, Opennote

A lot of students tell us that the moment their connected tools start talking to each other inside Opennote feels almost magical. The agent just knows them, and it has immensely helped in keeping new users on the platform.

Nirman DaveCEO, Zams

We chose Composio over Pipedream because it delivered depth where it mattered. It supported niche tools and tricky edge cases that other platforms simply ignored. Giving us confidence to scale without compromising.

Ryan YuFounder, Extra Thursday

As a solo builder, shipping fast is life or death. The only way I can outcompete incumbents is by outmanoeuvring them. Getting bogged down in the complexities of managing agent auth would have been a death sentence for Extra Thursday.

Tomisin JenrolaFounder & CEO, SwarmZero

Before partnering with Composio, adding tool integrations was a slow, resource-intensive process. Each integration could take weeks or months of engineering time, and maintaining them meant constantly keeping up with API changes.

Jerome LeclancheCo-Founder, Ingram Technologies

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Harsha GaddipatiCo-founder, Slashy

Abhi AryaCo-founder, Opennote

Nirman DaveCEO, Zams

Ryan YuFounder, Extra Thursday

Tomisin JenrolaFounder & CEO, SwarmZero

Jerome LeclancheCo-Founder, Ingram Technologies

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Harsha GaddipatiCo-founder, Slashy

Abhi AryaCo-founder, Opennote

Nirman DaveCEO, Zams

Ryan YuFounder, Extra Thursday

Tomisin JenrolaFounder & CEO, SwarmZero

Jerome LeclancheCo-Founder, Ingram Technologies

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.