- Category: developer tools
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 899
- Triggers: 46
- Slug:
GITHUB - Version: 20261103_00
Frequently Asked Questions
Does Composio support GitHub Apps?
Does Composio support GitHub Apps?
Tools
Abort Repository Migration
Abort Repository Migration
GITHUB_ABORT_REPOSITORY_MIGRATIONTool to abort a repository migration that is queued or in progress. Use when you need to cancel an ongoing migration operation.Input Parameters
Output
Accept a repository invitation
Accept a repository invitation
GITHUB_ACCEPT_REPOSITORY_INVITATIONAccepts a PENDING repository invitation that has been issued to the authenticated user.Input Parameters
Output
Add app access restrictions
Add app access restrictions
GITHUB_ADD_APP_ACCESS_RESTRICTIONSAdds GitHub Apps to the list of apps allowed to push to a protected branch. The branch must already have protection rules with restrictions enabled. This endpoint only works for organization repositories, not personal repositories. Apps must be installed on the repository with ‘contents’ write permissions.Input Parameters
.git extension. This field is not case-sensitive.Output
Add a repository collaborator
Add a repository collaborator
GITHUB_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.Input Parameters
.git extension. This name is not case sensitive.pull (read-only), triage (manage issues/PRs), push (read/write), maintain (manage most settings), admin (full control), or a custom repository role name if defined by the owning organization. This parameter is ignored for personal repositories, which grant push access.Output
Add assignees to an issue
Add assignees to an issue
GITHUB_ADD_ASSIGNEES_TO_AN_ISSUEAdds assignees to a GitHub issue. This action only adds users - it does not remove existing assignees. Changes are silently ignored if the authenticated user lacks push access to the repository.Input Parameters
.git extension. This field is not case sensitive.Output
Add email for auth user
Add email for auth user
GITHUB_ADD_EMAIL_ADDRESS_FOR_AUTHENTICATED_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.Input Parameters
Output
Add field to user project
Add field to user project
GITHUB_ADD_FIELD_TO_USER_PROJECTTool to add a custom field to a user-owned GitHub Projects V2 project. Use when you need to add fields like status, priority, or custom data to organize project items.Input Parameters
Output
Add item to user project
Add item to user project
GITHUB_ADD_ITEM_TO_USER_PROJECTTool to add an issue or pull request to a user-owned GitHub project. Use when you need to add existing repository items to a project board.Input Parameters
Output
Add labels to an issue
Add labels to an issue
GITHUB_ADD_LABELS_TO_AN_ISSUEAdds labels (provided in the request body) to a repository issue; labels that do not already exist are created.Input Parameters
Output
Add org runner labels
Add org runner labels
GITHUB_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.Input Parameters
Output
Add or update team membership for a user
Add or update team membership for a user
GITHUB_ADD_OR_UPDATE_TEAM_MEMBERSHIP_FOR_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.Input Parameters
Output
Add or update team project permissions
Add or update team project permissions
GITHUB_ADD_OR_UPDATE_TEAM_PROJECT_PERMISSIONSAdds a classic organization project to a team or updates the team’s permissions. GitHub sunset the Projects (classic) REST API on April 1, 2025; this does not manage Projects V2.Input Parameters
Output
Add or update team repository permissions
Add or update team repository permissions
GITHUB_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.Input Parameters
Output
Add project collaborator
Add project collaborator
GITHUB_ADD_PROJECT_COLLABORATORAdds a GitHub user as a collaborator to an organization project (classic) with a specified permission level. The Projects (classic) REST API was sunset on GitHub.com on April 1, 2025; adding collaborators requires organization-owner or project-admin access.Input Parameters
Output
Add a repository to an app installation
Add a repository to an app installation
GITHUB_ADD_REPOSITORY_TO_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.Input Parameters
Output
Add repo to org secret with selected access
Add repo to org secret with selected access
Add selected repo to org secret
Add selected repo to org secret
GITHUB_ADD_REPO_TO_ORG_SECRET_WITH_SELECTED_VISIBILITYGrants an existing repository access to an existing organization-level Dependabot secret when the secret’s visibility is set to ‘selected’; the repository must belong to the organization, and the call succeeds without change if access already exists.Input Parameters
Output
Add runner labels
Add runner labels
Add selected repository to an organization secret
Add selected repository to an organization secret
GITHUB_ADD_SELECTED_REPOSITORY_TO_ORGANIZATION_SECRETAdds a repository to the access list of an organization-level GitHub Codespaces secret with selected visibility.Input Parameters
Output
Add selected repository to an organization variable
Add selected repository to an organization variable
Add a selected repository to a user secret
Add a selected repository to a user secret
GITHUB_ADD_SELECTED_REPOSITORY_TO_USER_SECRETGrants a specified repository access to an authenticated user’s existing Codespaces secret, enabling Codespaces created for that repository to use the secret.Input Parameters
Output
Add status check contexts
Add status check contexts
GITHUB_ADD_STATUS_CHECK_CONTEXTSAdds status check contexts to a protected branch’s required status checks. This action appends new status check contexts to the existing list of required status checks for a protected branch. The branch must already have branch protection enabled with status checks configured. Note: The ‘contexts’ parameter is deprecated by GitHub in favor of ‘checks’ array. For new implementations, consider using update_status_check_protection with the ‘checks’ parameter instead.Input Parameters
.git extension. This name is not case sensitive.Output
Add sub-issue to an issue
Add sub-issue to an issue
GITHUB_ADD_SUB_ISSUETool to add a sub-issue to a parent GitHub issue using GraphQL. Use when you need to establish a parent-child relationship between issues. Requires the ‘sub_issues’ GraphQL feature to be enabled.Input Parameters
Output
Add team access restrictions
Add team access restrictions
GITHUB_ADD_TEAM_ACCESS_RESTRICTIONSAdds teams to the list of teams with push access to a protected branch. This action grants additional teams push access to a protected branch. Unlike ‘Set team access restrictions’ (PUT), this action adds to the existing list rather than replacing it entirely. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must exist in the organization and have repository accessInput Parameters
.git extension. This value is not case-sensitive.Output
Add user access restrictions
Add user access restrictions
GITHUB_ADD_USER_ACCESS_RESTRICTIONSAdds users to the list of people allowed to push to a protected branch in an organization repository. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must already have protection rules with restrictions enabled - Users must have write access to the repository to be added - The combined total of users, apps, and teams is limited to 100 itemsInput Parameters
.git extension. This name is not case-sensitive.Output
Add users to codespaces access for an organization
Add users to codespaces access for an organization
GITHUB_ADD_USERS_TO_CODESPACES_ACCESS_FOR_ORGANIZATIONAdds organization members to the list of users granted Codespaces access billed to the organization. IMPORTANT: This endpoint requires the organization’s Codespaces billing access to be set to ‘selected_members’ mode. If not already configured, use the GITHUB_MANAGE_ACCESS_CONTROL_FOR_ORGANIZATION_CODESPACES action first to set visibility to ‘selected_members’.Input Parameters
Output
Get GitHub API root
Get GitHub API root
Approve a workflow run for a fork pull request
Approve a workflow run for a fork pull request
GITHUB_APPROVE_WORKFLOW_RUN_FOR_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.Input Parameters
.git extension. The name is not case sensitive.Output
Assign an organization role to a team
Assign an organization role to a team
GITHUB_ASSIGN_ORGANIZATION_ROLE_TO_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.Input Parameters
Output
Assign an organization role to a user
Assign an organization role to a user
GITHUB_ASSIGN_ORGANIZATION_ROLE_TO_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.Input Parameters
Output
List Docker Migration Conflicting Packages
List Docker Migration Conflicting Packages
GITHUB_AUTH_USER_DOCKER_CONFLICT_PACKAGES_LISTList Docker packages with migration conflicts for the authenticated user. This endpoint lists all Docker packages owned by the authenticated user that encountered namespace conflicts during the Docker-to-GitHub Container Registry (GHCR) migration. Conflicts occur when a package with the same name exists in both the legacy Docker registry and GHCR. IMPORTANT: The Docker registry for GitHub Packages was deprecated on Feb 24, 2025. This endpoint may return a 400 error with message ‘Package migration for docker is no longer supported’ as the migration period has ended. In this case, the action returns an informative response instead of failing. Use case: Identifying packages that require manual migration to GHCR. Required scope: read:packages (for OAuth and personal access tokens).Output
Block a user
Block a user
Block a user from an organization
Block a user from an organization
GITHUB_BLOCK_USER_FROM_ORGANIZATIONBlocks a GitHub user from an organization, preventing contributions, collaboration, and forking of its repositories; requires admin or ‘Blocking users’ organization permission. Certain permission and validation errors return a response with success=false.Input Parameters
Output
Cancel a GitHub Pages deployment
Cancel a GitHub Pages deployment
Cancel sponsorship
Cancel sponsorship
GITHUB_CANCEL_SPONSORSHIPTool to cancel an active GitHub sponsorship using GraphQL. Use when you need to terminate a sponsorship relationship between a sponsor and a sponsorable entity. Either sponsor ID/login and sponsorable ID/login must be provided.Input Parameters
Output
Cancel a workflow run
Cancel a workflow run
Check if following user
Check if following user
Check if a gist is starred
Check if a gist is starred
GITHUB_CHECK_IF_GIST_IS_STARREDChecks whether the authenticated user has starred a GitHub gist. Returns true for HTTP 204 or 304 and false for HTTP 404; an unexpected successful status also yields false with a status message.Input Parameters
Output
Check if pull request merged
Check if pull request merged
Check if pull request merged
Check if pull request merged
GITHUB_CHECK_IF_PULL_REQUEST_MERGEDChecks whether a GitHub pull request has been merged. Returns merged=True for HTTP 204 and merged=False for HTTP 404; a 404 can also mean the pull request does not exist.Input Parameters
Output
Check if repo starred by auth user
Check if repo starred by auth user
GITHUB_CHECK_IF_REPO_STARRED_BY_AUTH_USERChecks whether the authenticated user has starred a specified GitHub repository. This action is deprecated.Input Parameters
.git extension. This name is not case sensitive.Output
Check if a user can be assigned
Check if a user can be assigned
GITHUB_CHECK_IF_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.Input Parameters
.git extension. This name is not case sensitive.Output
Check if a user can be assigned to an issue
Check if a user can be assigned to an issue
Check if a user follows another user
Check if a user follows another user
Check if a user is blocked by the authenticated user
Check if a user is blocked by the authenticated user
Check if a user is blocked by an organization
Check if a user is blocked by an organization
GITHUB_CHECK_IF_USER_IS_BLOCKED_BY_ORGANIZATIONChecks whether a GitHub user is blocked by an organization; requires ‘Blocking users’ organization permission (read access). Returns is_blocked=True for HTTP 204, False for HTTP 404, and a null status with an error for HTTP 403.Input Parameters
Output
Check if a user is a repository collaborator
Check if a user is a repository collaborator
GITHUB_CHECK_IF_USER_IS_REPOSITORY_COLLABORATORChecks whether a user is a collaborator on a GitHub repository, returning a boolean for HTTP 204 or 404; a 404 can also mean the repository or user does not exist. A 403 returns an indeterminate result with a permission error.Input Parameters
.git extension. This name is not case sensitive.Output
Check organization membership for user
Check organization membership for user
GITHUB_CHECK_ORGANIZATION_MEMBERSHIP_FOR_USERCheck whether a user has membership visible to the connected account. GitHub documents 404 as a negative result only when the requester is an organization member. It can otherwise indicate hidden membership, insufficient access, or a missing organization or user.Input Parameters
Output
Check if person is followed by authenticated user
Check if person is followed by authenticated user
GITHUB_CHECK_PERSON_FOLLOWED_BY_AUTH_USERChecks if the authenticated GitHub user follows a target GitHub user. Returns a structured response with is_following=True when following (HTTP 204), or is_following=False when not following (HTTP 404).Input Parameters
Output
Check private vulnerability reporting status
Check private vulnerability reporting status
GITHUB_CHECK_PRIVATE_VULNERABILITY_REPORTING_STATUSChecks if private vulnerability reporting is enabled for the specified repository.Input Parameters
.git extension. This field is not case-sensitive.Output
Check public organization membership
Check public organization membership
Check if repository is starred
Check if repository is starred
GITHUB_CHECK_REPOSITORY_STARREDCheck if a repository is starred by the authenticated user. Use this action when you need to verify whether the authenticated user has starred a specific repository. This is useful for confirming star status before performing star/unstar operations or displaying repository status.Input Parameters
.git extension. The name is not case sensitive.Output
Check team permissions for a project
Check team permissions for a project
Check team permissions for a repository
Check team permissions for a repository
GITHUB_CHECK_TEAM_PERMISSIONS_FOR_A_REPOSITORYChecks a team’s permissions for a specific repository within an organization, including permissions inherited from parent teams.Input Parameters
.git extension. This field is not case-sensitive.org parameter. This field is not case-sensitive.Output
Check a token
Check a token
GITHUB_CHECK_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. NOTE: This endpoint requires Basic Authentication using the OAuth App’s client_id as username and client_secret as password. The access_token parameter must be an OAuth token issued by the specified OAuth App.Input Parameters
Output
Clear Project V2 Item Field Value
Clear Project V2 Item Field Value
GITHUB_CLEAR_PROJECT_V2_ITEM_FIELD_VALUETool to clear the value of a field for an item in a GitHub Project V2. Use when you need to remove or reset a field value (text, number, date, assignees, labels, single-select, iteration, or milestone fields).Input Parameters
Output
Clear repository cache by key
Clear repository cache by key
GITHUB_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.Input Parameters
${{ runner.os }}-npm-${{ hashFiles('**/package-lock.json') }}).refs/heads/<branch_name>. To target caches for a pull request, use refs/pull/<pull_number>/merge. If omitted, caches matching the key across all refs are considered..git extension. The name is not case sensitive.Output
Clear self-hosted runner org labels
Clear self-hosted runner org labels
GITHUB_CLEAR_SELF_HOSTED_RUNNER_ORG_LABELSRemoves all custom labels from a self-hosted runner for an organization; default labels (e.g., ‘self-hosted’, ‘linux’, ‘x64’) will remain.Input Parameters
Output
Close an issue
Close an issue
GITHUB_CLOSE_ISSUEClose a GitHub issue by setting its state to closed. Use this action when you need to mark an issue as resolved or no longer relevant. Optionally specify a reason for closing (completed or not_planned) to provide context.Input Parameters
.git extension. The name is not case sensitive.Output
Close a pull request
Close a pull request
GITHUB_CLOSE_PULL_REQUESTCloses an open pull request without merging it. The pull request state is set to “closed” and it can be reopened later if needed. Use this action when you want to reject or abandon a pull request without merging the proposed changes into the base branch. You must have write access to the repository to close pull requests.Input Parameters
.git extension. This name is not case-sensitive.Output
Commit Multiple Files
Commit Multiple Files
GITHUB_COMMIT_MULTIPLE_FILESCreates, updates, or deletes repository files in a commit, with retries for non-fast-forward branch updates; a new branch in a nonempty repository requires a base branch. Empty repository initialization creates separate commits per file and may also write an initialization file to the default branch.Input Parameters
Output
Compare two commits
Compare two commits
GITHUB_COMPARE_TWO_COMMITSCompares two commit points (commits, branches, tags, or SHAs) within a repository or across forks, using BASE...HEAD or OWNER:REF...OWNER:REF format for the basehead parameter.Input Parameters
.git extension. This field is not case-sensitive.BASE...HEAD. BASE and HEAD can be branch names (e.g., main...develop), tag names (e.g., v1.0.0...v1.1.0), or commit SHAs (abbreviated or full 40-character format). Both abbreviated and full SHAs are accepted; full 40-character SHAs are recommended for reliability in large repositories. Both references must exist in the specified repository. To compare branches across forks in the same network, use the format OWNER:REF...OWNER:REF (e.g., octocat:main...another-user:main). Do NOT pass GitHub URLs - only plain reference strings like ‘main…develop’ are accepted.Output
Configure JIT runner for an org
Configure JIT runner for an org
GITHUB_CONFIGURE_JIT_RUNNER_FOR_ORGGenerates a JIT configuration for a GitHub organization’s new self-hosted runner to run a single job then unregister; requires admin:org scope and the runner_group_id must exist in the organization.Input Parameters
Output
Configure OIDC subject claim template
Configure OIDC subject claim template
GITHUB_CONFIGURE_OIDC_SUBJECT_CLAIM_TEMPLATESets or updates the OIDC subject claim customization template for an existing GitHub organization by specifying which claims (e.g., ‘repo’, ‘actor’) form the OIDC token’s subject (sub). This action customizes which claim keys are included in the OIDC subject claim for the specified organization. It allows for fine-tuning the content of the subject claim based on organizational needs.Input Parameters
sub).Output
Convert an organization member to outside collaborator
Convert an organization member to outside collaborator
GITHUB_CONVERT_ORG_MEMBER_TO_OUTSIDE_COLLABORATORConverts a GitHub organization member to an outside collaborator with access restricted to explicitly granted repositories. The conversion can be requested asynchronously; queued and completed responses are both returned as empty results.Input Parameters
Output
Convert Pull Request to Draft
Convert Pull Request to Draft
GITHUB_CONVERT_PULL_REQUEST_TO_DRAFTConverts an open pull request to draft status, indicating it is not ready for review. Use this action when you need to mark a PR as work-in-progress after it has been opened. Draft pull requests cannot be merged until they are marked as ready for review. This action is useful when additional work is needed before the PR can be reviewed or merged.Input Parameters
Output
Create a blob
Create a blob
GITHUB_CREATE_A_BLOBCreates a Git blob in a repository, requiring content and encoding (‘utf-8’ or ‘base64’). Requires write access to the repository.Input Parameters
Output
Create a check run
Create a check run
GITHUB_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. NOTE: This endpoint requires GitHub App authentication - OAuth tokens and personal access tokens cannot create check runs.Input Parameters
.git extension. This name is not case sensitive.status to waiting, pending, or requested.label (button text), identifier (unique ID for the action), and description (tooltip). Clicking a button sends a check_run.requested_action webhook to your app.completed_at is provided or if status is completed. Specifies the final outcome of the check (e.g., ‘success’, ‘failure’). Note: Setting conclusion automatically sets status to completed. GitHub alone can set a conclusion to stale.status is completed.alt (alternative text), image_url (URL of the image), and an optional caption.path, start_line, end_line, annotation_level (‘notice’, ‘warning’, or ‘failure’), and message. Optional fields include start_column, end_column, title, and raw_details. Up to 50 annotations per API request; for more, use subsequent ‘Update a check run’ calls. GitHub Actions limits are 10 warnings and 10 errors per step.Output
Create a check suite
Create a check suite
GITHUB_CREATE_A_CHECK_SUITECreates a new check suite for a specific commit (head_sha) in an original repository (not a fork). IMPORTANT: This endpoint requires a GitHub App installation access token - OAuth tokens and classic personal access tokens cannot use this endpoint. GitHub dispatches a check_suite webhook event with the requested action upon success.Input Parameters
Output
Create a codespace for the authenticated user
Create a codespace for the authenticated user
GITHUB_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)). This action allows users to set up a development environment quickly by creating a codespace from a specified repository or pull request.Input Parameters
Output
Create a codespace from a pull request
Create a codespace from a pull request
GITHUB_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.Input Parameters
UsEast, EuropeWest); supersedes location. If unspecified, typically IP-derived.standardLinux). Varies by CPU, RAM, storage. Uses default if unspecified.EastUs, WestEurope). This parameter is deprecated; use geo. If unspecified, location may be IP-derived.geo or location are not specified.true to prevent GitHub from requesting additional repository permissions defined in devcontainer.json. Defaults to false (permissions will be requested).Output
Create a codespace in a repository
Create a codespace in a repository
GITHUB_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.json if devcontainer_path is specified.Input Parameters
location; determined by user IP if not specified.geo.location and geo are unspecified; useful for proxied requests.devcontainer.json in the repository; uses .devcontainer/devcontainer.json or devcontainer.json at root if not specified.true, opts out of granting multi-repository permissions from devcontainer.json. If unspecified or false, permissions are granted if requested.Output
Create a commit
Create a commit
GITHUB_CREATE_A_COMMITCreates a Git commit object in a GitHub repository using an existing tree SHA and optional existing parent commit SHAs. It does not update a branch reference.Input Parameters
gpgsig header if provided.YYYY-MM-DDTHH:MM:SSZ) when the commit was committed. Defaults to author_date or current time.Output
Create a commit comment
Create a commit comment
GITHUB_CREATE_A_COMMIT_COMMENTCreates a comment on a specific commit, or on a specific line if path and position are provided.Input Parameters
position instead. Line number in the file to comment on. position takes precedence if both are provided.path is specified.Output
Create a commit status
Create a commit status
Create a custom organization role
Create a custom organization role
GITHUB_CREATE_A_CUSTOM_ORGANIZATION_ROLECreates a custom role with defined permissions within a GitHub organization.Input Parameters
Output
Create a deploy key
Create a deploy key
GITHUB_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.Input Parameters
true, the deploy key will only have read access. If false (default), the key will have read and write access. Write access grants significant privileges.Output
Create a deployment
Create a deployment
GITHUB_CREATE_A_DEPLOYMENTCreates a GitHub deployment for an existing repository, targeting a specific ref (branch, tag, or SHA). By default, it may attempt to merge the default branch into the requested ref if it is behind.Input Parameters
.git extension. This name is not case-sensitive. The repository must exist and the authenticated user must have write access to it.false to disable.null, GitHub verifies all unique contexts. Pass an empty list [] to bypass all checks.true if the environment is temporary.Output
Create a deployment branch policy
Create a deployment branch policy
GITHUB_CREATE_A_DEPLOYMENT_BRANCH_POLICYCreates a deployment branch or tag policy for an existing environment in a GitHub repository, using a Ruby File.fnmatch pattern (where * doesn’t match /) to specify which branches or tags are deployable.Input Parameters
* won’t match /, e.g., release/*/* for release/feature/login). Refer to Ruby File.fnmatch documentation.Output
Create a deployment status
Create a deployment status
GITHUB_CREATE_A_DEPLOYMENT_STATUSCreates a status for an existing deployment, updating its operational state, associated URLs, and description.Input Parameters
.git extension. The name is not case sensitive.inactive shows it as destroyed in GitHub.target_url; setting this also sets target_url to the same value.production, staging). If unset, uses environment from previous status or deployment.inactive.Output
Create a discussion
Create a discussion
Create a discussion comment
Create a discussion comment
Create a fork
Create a fork
GITHUB_CREATE_A_FORKCreates a fork of an accessible repository, optionally into a specific organization, with a new name, or copying only the default branch.Input Parameters
.git extension. This field is not case sensitive.True, only the default branch is copied. If False or not specified, all branches are copied.Output
Create a gist
Create a gist
GITHUB_CREATE_A_GISTCreates a new gist on GitHub with provided files, an optional description, and public/secret visibility.Input Parameters
content key with the file’s raw string data.Output
Create a gist comment
Create a gist comment
Create a GitHub App from a manifest
Create a GitHub App from a manifest
GITHUB_CREATE_A_GITHUB_APP_FROM_A_MANIFESTUse this action to complete the GitHub App Manifest flow (step 3 of 3) by exchanging the temporary authorization code for the app’s full configuration, including credentials and private key. The code is provided via redirect URL after creating the app through GitHub’s web interface and must be used within 1 hour.Input Parameters
Output
Create a github pages deployment
Create a github pages deployment
GITHUB_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.Input Parameters
.git extension. This field is not case-sensitive.secrets.GITHUB_TOKEN with id-token: write permission.artifact_url is required.artifact_id is required.GITHUB_SHA.Output
Create a github pages site
Create a github pages site
GITHUB_CREATE_A_GITHUB_PAGES_SITECreates a GitHub Pages site for a repository, with a choice of build type and source location.Input Parameters
source_branch is provided, defaults to ‘legacy’. When ‘workflow’, source_branch and source_path are ignored.source_branch for site source files (e.g., ’/’ for root, ‘/docs’). Ignored if build_type is ‘workflow’.build_type is ‘legacy’ or not specified. It is ignored if build_type is ‘workflow’.Output
Create a label
Create a label
GITHUB_CREATE_A_LABELCreates a label in a specified GitHub repository, provided the repository exists and the user has write permissions. If the label name already exists, it may return a message instead of creating a label.Input Parameters
:strawberry: will render the emoji 
f29513), without the leading #. Required parameter.Output
Create a milestone
Create a milestone
Create an autolink reference for a repository
Create an autolink reference for a repository
GITHUB_CREATE_AN_AUTOLINK_REFERENCE_FOR_A_REPOSITORYCreates a repository autolink to automatically convert text references (e.g., ‘TICKET-123’) into hyperlinks, using a unique key_prefix and a url_template that includes <num>.Input Parameters
.git extension. The name is not case-sensitive.<num> as a placeholder for the reference identifier (e.g., ‘https://example.atlassian.net/browse/<num>’). Behavior of <num> is determined by is_alphanumeric.<num> placeholder in url_template matches alphanumeric characters (A-Z (case-insensitive), 0-9, and -) or only numeric characters (0-9).Output
Create an environment variable
Create an environment variable
GITHUB_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.Input Parameters
.git extension. This field is not case-sensitive.your_secret_token). This value will be encrypted./ must be replaced with %2F).Output
Create an issue
Create an issue
GITHUB_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.Input Parameters
.git extension (case-insensitive). The repository must exist, be accessible, and have issues enabled.assignees.Output
Create an issue comment
Create an issue comment
Create an organization project
Create an organization project
GITHUB_CREATE_AN_ORGANIZATION_PROJECTCreates a classic project board in a specified GitHub organization, with a name and optional description, for organizing project work. DEPRECATED: GitHub.com has disabled new classic project creation and sunset the classic REST API. Use GitHub Projects V2 instead.Input Parameters
Output
Create an organization repository
Create an organization repository
GITHUB_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.Input Parameters
squash_merge_commit_title. Default to pull request title for squash-merge commits.Output
Create an organization variable
Create an organization variable
GITHUB_CREATE_AN_ORGANIZATION_VARIABLECreates a new, uniquely named GitHub Actions variable for an organization, with configurable repository access visibility (all, private, or selected).Input Parameters
selected_repository_ids).visibility is set to ‘selected’.Output
Create an organization webhook
Create an organization webhook
GITHUB_CREATE_AN_ORGANIZATION_WEBHOOKCreates a webhook for a GitHub organization to deliver event notifications to a configured URL.Input Parameters
true sends notifications, false does not. Defaults to true.['*'] for all events. Defaults to ['push'] if not specified. See GitHub docs for event types.config object and will receive POST requests for subscribed events.config_url) requires it, corresponding to config_username.config_url) requires it. Use only if your endpoint is protected by basic auth.json, form. GitHub API defaults to form if this field is not set or is None.config_url. ‘1’ disables verification (not recommended), ‘0’ enables. GitHub API defaults to ‘0’ (verification enabled) if this field is not set or is None.Output
Create a project card
Create a project card
GITHUB_CREATE_A_PROJECT_CARDCreates a card in a GitHub Projects (classic) column, either as a note or linked to an issue or pull request. DEPRECATED: The Projects (classic) REST API has been sunset, and Projects (classic) was removed from GitHub Enterprise Server 3.17. Use the newer GitHub Projects instead.Input Parameters
/projects/columns/{column_id}/cards).Output
Create a project column (Classic - Deprecated)
Create a project column (Classic - Deprecated)
GITHUB_CREATE_A_PROJECT_COLUMNCreates a named column in a GitHub Projects (classic) project to organize its cards. DEPRECATED: The Projects (classic) REST API has been sunset and this action no longer works on GitHub.com. Use GitHub Projects V2 with its GraphQL API instead.Input Parameters
Output
Create a pull request
Create a pull request
GITHUB_CREATE_A_PULL_REQUESTCreates a pull request in a GitHub repository, requiring existing base and head branches; title or issue must be provided.Input Parameters
head with the source owner and branch, like username:branch..git extension. This name is not case-sensitive.title is not specified.Output
Create a reference
Create a reference
GITHUB_CREATE_A_REFERENCECreates a NEW Git reference (branch or tag) in a repository. IMPORTANT: This action ONLY creates NEW references - if the reference already exists, it will fail with a 422 ‘Reference already exists’ error. To update an existing reference, use the ‘Update a reference’ (GITHUB_UPDATE_A_REFERENCE) action instead. The repository must not be empty prior to this operation.Input Parameters
refs/heads/master, refs/tags/v1.0.0). Must start with refs/ and contain at least two slashes..git extension. The name is not case sensitive.Output
Create a registration token for an organization
Create a registration token for an organization
Create a registration token for a repository
Create a registration token for a repository
GITHUB_CREATE_A_REGISTRATION_TOKEN_FOR_A_REPOSITORYGenerates a time-limited token required to register a new self-hosted runner with a specific repository.Input Parameters
.git extension. This field is not case-sensitive.Output
Create a release
Create a release
GITHUB_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.Input Parameters
generate_release_notes is false, it defaults to the tag_name.tag_name doesn’t exist yet.true to automatically generate the release title (name) and description (body) from the commit history since the last release. Defaults to false.Output
Create a remove token for an organization
Create a remove token for an organization
GITHUB_CREATE_A_REMOVE_TOKEN_FOR_AN_ORGANIZATIONGenerates a token, valid for one hour, to authenticate removing a self-hosted runner from an organization.Input Parameters
Output
Create a remove token for a repository
Create a remove token for a repository
Create a reply for a review comment
Create a reply for a review comment
GITHUB_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.Input Parameters
.git extension. The name is not case sensitive.Output
Create a repository dispatch event
Create a repository dispatch event
GITHUB_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.Input Parameters
Output
Create a repository for the authenticated user
Create a repository for the authenticated user
GITHUB_CREATE_A_REPOSITORY_FOR_THE_AUTHENTICATED_USERCreates a new repository for the authenticated user.Input Parameters
PR_TITLE uses the pull request’s title. MERGE_MESSAGE uses a classic title like ‘Merge pull request #123 from branch-name’. Required when merge_commit_message is set. Valid combinations: (PR_TITLE, PR_BODY), (PR_TITLE, BLANK), (MERGE_MESSAGE, PR_TITLE).PR_BODY uses the pull request’s body. PR_TITLE uses the pull request’s title. BLANK results in a blank commit message. Valid combinations with merge_commit_title: (PR_TITLE, PR_BODY), (PR_TITLE, BLANK), (MERGE_MESSAGE, PR_TITLE).PR_TITLE uses the pull request’s title. COMMIT_OR_PR_TITLE uses the commit’s title (if only one commit) or the pull request’s title (if multiple commits).PR_BODY uses the pull request’s body. COMMIT_MESSAGES uses the branch’s commit messages. BLANK results in a blank commit message.Output
Create a repository from an unpublished codespace
Create a repository from an unpublished codespace
GITHUB_CREATE_A_REPOSITORY_FROM_AN_UNPUBLISHED_CODESPACEPublishes the specified codespace to a new repository, using the codespace’s current state as the initial commit.Input Parameters
true for a private repository, or false for a public one. Defaults to false (public).Output
Create a repository project
Create a repository project
GITHUB_CREATE_A_REPOSITORY_PROJECTCreates a GitHub Projects V2 project owned by the repository owner and linked to the specified repository. A supplied project description is not applied during creation.Input Parameters
.git extension. The name is not case sensitive.Output
Create a repository ruleset
Create a repository ruleset
GITHUB_CREATE_A_REPOSITORY_RULESETCreates a uniquely named ruleset for a repository, defining rules for branches or tags with specified enforcement, conditions, and bypass actors.Input Parameters
type and may have parameters. Refer to GitHub API docs for available rule types and parameters. Example: ’[{“type”: “creation”}, {“type”: “deletion”}]’disabled (ruleset is not enforced), active (ruleset is enforced), or evaluate (test rules before enforcing; GitHub Enterprise only).actor_id, actor_type (e.g., ‘Team’, ‘Integration’), and bypass_mode (e.g., ‘always’). Example: ’[{“actor_id”: 1, “actor_type”: “Team”, “bypass_mode”: “always”}]’~DEFAULT_BRANCH for default branch, ~ALL for all branches.Output
Create a repository using a template
Create a repository using a template
GITHUB_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.Input Parameters
.git extension. This field is not case-sensitive.true to copy the directory structure and files from all branches of the template repository, not just the default branch.Output
Create a repository variable
Create a repository variable
GITHUB_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.Input Parameters
GITHUB_ prefix, and spaces are not allowed..git extension. This field is not case sensitive.Output
Create a repository webhook
Create a repository webhook
GITHUB_CREATE_A_REPOSITORY_WEBHOOKCreates a webhook for a specified repository; requires admin permissions on the repository.Input Parameters
web. This parameter currently only accepts web and defaults to web if not provided..git extension. This name is not case sensitive.true sends notifications (active), false disables them (inactive).['push'], ['issues']). See GitHub documentation for ‘webhook event payloads’.json or form. Defaults to form if not specified. json delivers JSON, form delivers URL-encoded data.Output
Create a review comment for a pull request
Create a review comment for a pull request
GITHUB_CREATE_A_REVIEW_COMMENT_FOR_A_PULL_REQUESTCreates a review comment on a pull request diff at a specific line or range, using a diff position, or as a reply to an existing review comment.Input Parameters
side). For multi-line comments, this is the last line of the range. Do not use with position or in_reply_to parameters.LEFT or RIGHT) for the comment. Required when using line-based mode with the line parameter. For multi-line comments, refers to the last line of the range. Do not use with position or in_reply_to parameters. IMPORTANT: Use LEFT only for deletions that appear in red in the diff. Use RIGHT for additions (green) or unchanged context lines (white). Attempting to comment on LEFT side lines that are not visible deletions in the diff will result in a ‘could not be resolved’ error.commit_id can misplace the comment if lines change.start_side, line, and side). Do not use with position or in_reply_to parameters.LEFT or RIGHT) for a multi-line comment. Required when creating a multi-line comment (must be used with start_line, line, and side). Do not use with position or in_reply_to parameters. IMPORTANT: Use LEFT only for deletions that appear in red in the diff. Use RIGHT for additions (green) or unchanged context lines (white). Attempting to use LEFT for lines that are not visible deletions will result in a ‘could not be resolved’ error.Output
Create a review for a pull request
Create a review for a pull request
GITHUB_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.Input Parameters
APPROVE, REQUEST_CHANGES, COMMENT); if omitted, review is PENDING and requires later submission.path (relative file path) and body (comment text). Optionally, specify line (or start_line for multi-line), and side (or start_side) for diff location. position is deprecated; use line. Example: [{'path': 'file.py', 'line': 10, 'body': 'Refactor this.'}]Output
Create a scoped access token
Create a scoped access token
GITHUB_CREATE_A_SCOPED_ACCESS_TOKENCreates a repository-scoped and/or permission-scoped GitHub App user access token from a non-scoped user token. The endpoint requires Basic authentication with the app’s client ID and client secret; repository scope may be specified by names or IDs.Input Parameters
target_id is not provided.target is not provided.contents: write. Applies to target repositories.Output
Create a dependency snapshot
Create a dependency snapshot
GITHUB_CREATE_A_SNAPSHOT_OF_DEPENDENCIES_FOR_A_REPOSITORYCreates a snapshot of a repository’s dependencies to populate the GitHub dependency graph and enable security alerts; sha must be a 40-character commit ID, ref a fully qualified Git reference (e.g., refs/heads/main), and scanned an ISO 8601 timestamp.Input Parameters
refs/heads/main) of the repository branch/tag that triggered this snapshot.job.correlator and detector.name, only the ‘latest’ snapshot is current. Useful to distinguish detection runs (e.g., concatenating GITHUB_WORKFLOW and GITHUB_JOB).Output
Create a tag object
Create a tag object
GITHUB_CREATE_A_TAG_OBJECTCreates an annotated Git tag object in a repository, pointing to an existing commit, tree, or blob identified by its SHA and specified type.Input Parameters
.git extension. This name is not case-sensitive.YYYY-MM-DDTHH:MM:SSZ.Output
Create a tag protection state for a repository
Create a tag protection state for a repository
GITHUB_CREATE_A_TAG_PROTECTION_STATE_FOR_A_REPOSITORYCreates a legacy tag protection rule for a repository, using a glob pattern to select protected tags. DEPRECATED: GitHub sunset the tag protection API on GitHub.com and says it returns null data; use GITHUB_CREATE_A_REPOSITORY_RULESET to protect tags with repository rulesets instead.Input Parameters
v1.* (protects tags starting with v1.), * (protects all tags).Output
Create a team
Create a team
GITHUB_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’.Input Parameters
parent_team_id is set.privacy must be ‘closed’.Output
Create a temporary private fork
Create a temporary private fork
GITHUB_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.Input Parameters
Output
Create a tree
Create a tree
GITHUB_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.Input Parameters
.git extension. The name is not case sensitive.path (string), mode (string; e.g., ‘100644’ file, ‘100755’ executable, ‘040000’ subdirectory/tree, ‘160000’ submodule, ‘120000’ symlink), and type (string: ‘blob’, ‘tree’, or ‘commit’). For new/updated blobs, provide content (UTF-8 string). For existing objects or tree/commit types, provide sha (string). To delete, specify path, mode, type, and set sha to null.tree entries, where tree entries overwrite those from base_tree with the same path. Typically the SHA1 of the latest commit’s tree for new branch changes. If omitted, the new tree is built from tree entries; files from the parent commit’s tree not in tree are treated as deleted.Output
Create a user project
Create a user project
GITHUB_CREATE_A_USER_PROJECTCreates a GitHub Projects V2 project board for the authenticated user using the GraphQL API. An optional project description is accepted but not applied during creation.Input Parameters
Output
Create a workflow dispatch event
Create a workflow dispatch event
GITHUB_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.Input Parameters
on.workflow_dispatch.inputs definitions (max 10); uses workflow defaults if omitted. Example: ’{“actor”: “mona”, “environment”: “production”}’Output
Create a branch
Create a branch
GITHUB_CREATE_BRANCHCreates a new branch in a GitHub repository pointing to a specified commit. Use this action when you need to create a new branch from an existing commit SHA. IMPORTANT: This action only creates NEW branches. If the branch already exists, it will fail with a 422 ‘Reference already exists’ error. The repository must not be empty (must have at least one commit) before creating a branch.Input Parameters
Output
Create commit signature protection
Create commit signature protection
GITHUB_CREATE_COMMIT_SIGNATURE_PROTECTIONEnables commit signature protection for a specified branch, requiring all new commits to be signed.Input Parameters
.git extension. The name is not case sensitive.Output
Create a custom deployment protection rule on an environment
Create a custom deployment protection rule on an environment
GITHUB_CREATE_DEPLOYMENT_PROTECTION_RULEEnables a custom deployment protection rule for an existing environment in a repository by linking a configured GitHub App (via integration_id) to control deployments.Input Parameters
.git extension. This name is not case sensitive./ should be replaced with %2F).Output
Create draft item for user project
Create draft item for user project
Create inference chat completions
Create inference chat completions
GITHUB_CREATE_INFERENCE_CHAT_COMPLETIONSTool to create chat completions using GitHub Models inference API. Use when you need to generate AI-powered text responses using models like GPT-4, Claude, or Llama through GitHub’s inference endpoint.Input Parameters
Output
Create inference embeddings
Create inference embeddings
GITHUB_CREATE_INFERENCE_EMBEDDINGSTool to create inference embeddings using GitHub’s AI models. Use when you need to convert text into vector representations for similarity search, clustering, or other ML tasks.Input Parameters
Output
Create issue type
Create issue type
Create JIT runner config for repo
Create JIT runner config for repo
GITHUB_CREATE_JIT_RUNNER_CONFIGGenerates 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.Input Parameters
Output
Create or update an environment
Create or update an environment
GITHUB_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.Input Parameters
id and type (‘User’ or ‘Team’). Example: ’[{“id”: 4532, “type”: “User”}]’deployment_branch_policy_custom_branch_policies must then be false.deployment_branch_policy_protected_branches must then be false.Output
Create or update an environment secret
Create or update an environment secret
GITHUB_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.Input Parameters
/ becomes %2F).Output
Create or update an organization secret
Create or update an organization secret
GITHUB_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.Input Parameters
selected_repository_ids must be provided.visibility is ‘selected’.Output
Create or update a repository secret
Create or update a repository secret
GITHUB_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.Input Parameters
encrypted_value (obtained with the public key). Required if encrypted_value is provided.Output
Create or update a secret for the authenticated user
Create or update a secret for the authenticated user
GITHUB_CREATE_OR_UPDATE_A_SECRET_FOR_THE_AUTHENTICATED_USERCreates or updates a Codespaces secret for the authenticated user, optionally restricting access to selected repositories. Accepts plaintext and encrypts it using the user’s GitHub public key, or accepts a pre-encrypted value with its key ID.Input Parameters
encrypted_value. If not provided, it will be fetched automatically.key_id) obtained from GitHub’s ‘Get public key for the authenticated user’ endpoint.Output
Create or update custom properties for an organization
Create or update custom properties for an organization
GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTIES_FOR_AN_ORGCreates new custom property schemas or updates existing ones in bulk for a specified organization; each property definition must include property_name and value_type.Input Parameters
property_name (max 75 chars, no spaces) and value_type. Optional: description, required, default_value, allowed_values (for ‘single_select’ type).Output
Create or update a custom property for an organization
Create or update a custom property for an organization
GITHUB_CREATE_OR_UPDATE_CUSTOM_PROPERTY_ORGCreates a new custom property (name must be unique for creation) or updates an existing one for an organization to define metadata for its repositories.Input Parameters
single_select type, must be one of allowed_values. Can be a string for single values or an array for multi_select.value_type is single_select or multi_select.Output
Create or update file contents
Create or update file contents
GITHUB_CREATE_OR_UPDATE_FILE_CONTENTSCreates or updates a file in a GitHub repository with a commit message and supplied content. A missing non-default branch may result in the change being committed to the repository’s default branch. Content may be supplied as plain text or Base64.Input Parameters
author_email is also required. Defaults to committer details; if all committer/author details omitted, GitHub uses authenticated user.author_name is also required. Defaults to committer details; if all committer/author details omitted, GitHub uses authenticated user.committer_email is also required. GitHub uses authenticated user if all committer/author details omitted.committer_name is also required. GitHub uses authenticated user if all committer/author details omitted.Output
Create or Update GitHub Pages Site
Create or Update GitHub Pages Site
GITHUB_CREATE_OR_UPDATE_GITHUB_PAGES_SITEEnables or updates GitHub Pages configuration for a repository, including source, custom domain and HTTPS settings. The build type defaults to legacy, which requires a source branch even when updating an existing site.Input Parameters
Output
Create or update repo secret with encrypted value
Create or update repo secret with encrypted value
GITHUB_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. This action allows you to securely manage secrets for a given repository, ensuring that sensitive data remains protected during the update process. By providing the encrypted value alongside the key ID, you can seamlessly maintain the necessary credentials for your repository’s operations.Input Parameters
.git extension. This name is not case-sensitive.Output
Create reaction for a commit comment
Create reaction for a commit comment
GITHUB_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.Input Parameters
Output
Create reaction for an issue
Create reaction for an issue
GITHUB_CREATE_REACTION_FOR_AN_ISSUECreates a reaction for a specified issue within a GitHub repository.Input Parameters
.git extension. The name is not case-sensitive.Output
Create reaction for an issue comment
Create reaction for an issue comment
Create reaction for a pull request review comment
Create reaction for a pull request review comment
GITHUB_CREATE_REACTION_FOR_A_PULL_REQUEST_REVIEW_COMMENTAdds a specified reaction to a pull request review comment within a GitHub repository.Input Parameters
.git extension. This field is case-insensitive.Output
Create reaction for a release
Create reaction for a release
GITHUB_CREATE_REACTION_FOR_A_RELEASECreates an emoji reaction for a specific, existing release in a GitHub repository.Input Parameters
.git extension. This field is not case-sensitive.Output
Create reaction for a team discussion
Create reaction for a team discussion
Create reaction for a team discussion comment
Create reaction for a team discussion comment
GITHUB_CREATE_REACTION_FOR_A_TEAM_DISCUSSION_COMMENTAdds a reaction to a team discussion comment, requiring the specified organization, team, discussion, and comment to exist.Input Parameters
Output
Create repository
Create repository
GITHUB_CREATE_REPOSITORYCreates a new repository for the authenticated user. Use this action when you need to create a new GitHub repository under the authenticated user’s account. The repository name must be unique for the user, and various settings can be configured such as visibility (public/private), enabled features (issues, wiki, projects), and merge options.Input Parameters
Output
Create sponsorship
Create sponsorship
GITHUB_CREATE_SPONSORSHIPTool to start a new GitHub sponsorship or reactivate a past sponsorship using GraphQL. Use when you need to sponsor a maintainer through GitHub Sponsors with a specified amount and privacy level.Input Parameters
Output
Create Sponsors Tier
Create Sponsors Tier
GITHUB_CREATE_SPONSORS_TIERCreate a GitHub Sponsors payment tier for a specified user or organization using GraphQL, with an amount and description.Input Parameters
Output
Create or Update Organization Secret with LibSodium
Create or Update Organization Secret with LibSodium
GITHUB_CREATE_UPDATE_ORG_SECRET_WITH_LIB_SODIUMCreates 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.Input Parameters
encrypted_value is provided.all (all repositories), private (private repositories), or selected (specific repositories designated by selected_repository_ids).visibility is selected.Output
Create user list
Create user list
Create view for user project
Create view for user project
GITHUB_CREATE_VIEW_FOR_USER_PROJECTTool to create a new view in a user-owned GitHub project (Projects V2). Use when you need to add a customized view with specific layout, filters, and visible fields to organize project items. Note: This action works with GitHub Projects V2. The view can be configured with different layouts (table, board, roadmap) and optional filters. The visible_fields parameter is not applicable to roadmap layouts.Input Parameters
Output
Decline a repository invitation
Decline a repository invitation
Delete access restrictions
Delete access restrictions
GITHUB_DELETE_ACCESS_RESTRICTIONSRemoves all user, team, and app-based access restrictions from a protected branch.Input Parameters
.git extension. This field is not case-sensitive.Output
Delete admin branch protection
Delete admin branch protection
Delete a file
Delete a file
GITHUB_DELETE_A_FILEDeletes a file by path from a GitHub repository. The file’s blob SHA is automatically fetched if not provided.Input Parameters
Output
Delete a package version for the authenticated user
Delete a package version for the authenticated user
GITHUB_DELETE_A_PACKAGE_VERSION_FOR_THE_AUTHENTICATED_USERDeletes an existing package version associated with the authenticated user.Input Parameters
maven for GitHub Gradle registry, container for ghcr.io images. The docker type covers images from docker.pkg.github.com (including migrated ones).Output
Delete an app token
Delete an app token
Delete a reference
Delete a reference
GITHUB_DELETE_A_REFERENCEDeletes a Git reference from a repository. Branch names may be supplied without a prefix; they are treated as branch references.Input Parameters
.git extension. This name is not case sensitive.Output
Delete a release
Delete a release
GITHUB_DELETE_A_RELEASEPermanently deletes a specific release, its assets, and potentially its associated Git tag from a repository.Input Parameters
.git extension. This field is not case-sensitive.Output
Delete a release asset
Delete a release asset
Delete a release reaction
Delete a release reaction
Delete a repository
Delete a repository
Delete a repository invitation
Delete a repository invitation
Delete a repository ruleset
Delete a repository ruleset
Delete a repository secret
Delete a repository secret
GITHUB_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.Input Parameters
.git extension. This field is not case-sensitive.Output
Delete a repository subscription
Delete a repository subscription
GITHUB_DELETE_A_REPOSITORY_SUBSCRIPTIONDeletes the authenticated user’s subscription to a specified repository if it exists, effectively ‘unwatching’ it.Input Parameters
.git extension. This name is not case-sensitive.Output
Delete a repository variable
Delete a repository variable
Delete a repository webhook
Delete a repository webhook
GITHUB_DELETE_A_REPOSITORY_WEBHOOKDeletes a specific webhook from a repository.Input Parameters
.git extension. This name is not case sensitive.X-GitHub-Hook-ID header of a webhook delivery.Output
Delete a review comment for a pull request
Delete a review comment for a pull request
GITHUB_DELETE_A_REVIEW_COMMENT_FOR_A_PULL_REQUESTDeletes a specific pull request review comment.Input Parameters
.git extension. This field is not case-sensitive.Output
Delete an artifact
Delete an artifact
Delete a secret for the authenticated user
Delete a secret for the authenticated user
GITHUB_DELETE_A_SECRET_FOR_THE_AUTHENTICATED_USERDeletes an existing Codespaces secret for the authenticated user by secret_name. This is a destructive and irreversible operation. Returns 404 if the secret does not exist.Input Parameters
GITHUB_ or contain spaces.Output
Delete a self hosted runner from an organization
Delete a self hosted runner from an organization
GITHUB_DELETE_A_SELF_HOSTED_RUNNER_FROM_AN_ORGANIZATIONRemoves a self-hosted runner from a GitHub organization, including when its machine no longer exists, immediately disconnecting it from GitHub Actions. Requires organization admin access and appropriate authorization; successful deletion returns a success message.Input Parameters
Output
Delete a self hosted runner from a repository
Delete a self hosted runner from a repository
Delete a tag protection state for a repository
Delete a tag protection state for a repository
GITHUB_DELETE_A_TAG_PROTECTION_STATE_FOR_A_REPOSITORYAttempts to delete a repository tag protection rule by ID using GitHub’s tag protection API, sunset on August 30, 2024. The response reports the HTTP status and a message, including for 404 and 410 responses.Input Parameters
.git extension. The name is not case sensitive.Output
Delete a team
Delete a team
Delete a thread subscription
Delete a thread subscription
GITHUB_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.Input Parameters
GET /notifications endpoint). Ensure this ID refers to an active thread to which the user is currently subscribed.Output
Delete an autolink reference from a repository
Delete an autolink reference from a repository
Delete a workflow run
Delete a workflow run
Delete branch protection
Delete branch protection
GITHUB_DELETE_BRANCH_PROTECTIONRemoves all protection rules from a specific branch in a GitHub repository; the branch must currently have protection rules enabled.Input Parameters
Output
Delete a code scanning analysis from a repository
Delete a code scanning analysis from a repository
GITHUB_DELETE_CODE_SCANNING_ANALYSISDeletes 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.Input Parameters
true to confirm deletion when this is the last analysis of its type for a specific tool and reference. Required to avoid a 400 error when deleting the final analysis in a set.Output
Delete a codespace for the authenticated user
Delete a codespace for the authenticated user
GITHUB_DELETE_CODESPACEDeletes a specific codespace owned by the authenticated user; this is a destructive action and the codespace must exist.Input Parameters
Output
Delete a commit comment
Delete a commit comment
GITHUB_DELETE_COMMIT_COMMENTDeletes a specific commit comment, identified by its comment_id, from the specified repository; the comment must exist.Input Parameters
.git extension. This value is not case-sensitive.Output
Delete a commit comment reaction
Delete a commit comment reaction
Delete commit signature protection
Delete commit signature protection
GITHUB_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.Input Parameters
.git extension. The name is not case-sensitive.Output
Delete a custom organization role
Delete a custom organization role
Delete dependabot secret by name
Delete dependabot secret by name
GITHUB_DELETE_DEPENDEBOT_SECRET_BY_NAMEDeletes a specific Dependabot secret, identified by its name, from a given repository if both the repository and secret exist.Input Parameters
.git extension. This field is not case-sensitive.Output
Delete a deploy key
Delete a deploy key
Delete a deployment
Delete a deployment
Delete a deployment branch policy
Delete a deployment branch policy
GITHUB_DELETE_DEPLOYMENT_BRANCH_POLICYDeletes a specific deployment branch or tag policy, identified by its ID, from a given environment within a repository.Input Parameters
.git extension. The name is not case sensitive.%2F.Output
Delete a discussion
Delete a discussion
Delete a discussion comment
Delete a discussion comment
Delete authenticated user email address
Delete authenticated user email address
Delete an environment
Delete an environment
GITHUB_DELETE_ENVIRONMENTDeletes an existing deployment environment from an existing repository.Input Parameters
/) should be replaced with %2F.Output
Delete an environment secret
Delete an environment secret
GITHUB_DELETE_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.Input Parameters
.git extension. This field is not case-sensitive.my_secret becomes MY_SECRET)./ should be replaced with %2F).Output
Delete an environment variable
Delete an environment variable
GITHUB_DELETE_ENVIRONMENT_VARIABLEDeletes a named environment variable from a specified, existing environment within a GitHub repository.Input Parameters
.git extension. The name is not case sensitive./ should be %2F).Output
Delete a gist
Delete a gist
Delete a gist comment
Delete a gist comment
Delete GitHub Actions cache by ID
Delete GitHub Actions cache by ID
Delete a GitHub Pages site
Delete a GitHub Pages site
GITHUB_DELETE_GITHUB_PAGES_SITEDeletes the GitHub Pages site for the specified repository; completes without error if no site is currently enabled.Input Parameters
.git extension. This name is not case-sensitive.Output
Delete an issue comment
Delete an issue comment
Delete an issue comment reaction
Delete an issue comment reaction
Delete an issue reaction
Delete an issue reaction
Delete a label
Delete a label
GITHUB_DELETE_LABELPermanently removes an existing label from a repository.Input Parameters
.git extension. Must be provided together with ‘owner’ to identify the repository (e.g., for ‘github.com/octocat/Hello-World’, repo is ‘Hello-World’). This field is not case-sensitive.Output
Delete a milestone
Delete a milestone
GITHUB_DELETE_MILESTONEDeletes the specified milestone if it exists; this operation is idempotent, typically returning a 404 if the milestone is not found or already deleted.Input Parameters
.git extension. This name is not case-sensitive.Output
Delete an organization
Delete an organization
Delete an organization secret
Delete an organization secret
Delete an organization variable
Delete an organization variable
Delete an organization webhook
Delete an organization webhook
Delete a codespace from the organization
Delete a codespace from the organization
Delete a package for an organization
Delete a package for an organization
GITHUB_DELETE_ORG_PACKAGEDeletes a specific package in an organization; public packages with over 5,000 downloads cannot be deleted. Authentication, permission and not-found errors can be returned as response messages rather than raised.Input Parameters
maven. Docker images in GitHub’s Container registry (ghcr.io) have type container. Use type docker for images previously in GitHub’s Docker registry (docker.pkg.github.com), even if migrated to the Container registry.Output
Delete a package for the authenticated user
Delete a package for the authenticated user
GITHUB_DELETE_PACKAGEPermanently deletes a specific package owned by the authenticated user; public packages downloaded over 5,000 times cannot be deleted via this API. A 404 is returned with success set to false rather than raised.Input Parameters
Output
Delete package version
Delete package version
GITHUB_DELETE_PACKAGE_VERSIONTool to delete a package version using GitHub GraphQL API. Use when you need to remove a specific version of a package by its global node ID.Input Parameters
Output
Delete package version for an organization
Delete package version for an organization
GITHUB_DELETE_PACKAGE_VERSION_FOR_AN_ORGANIZATIONDeletes a specific package version within an organization; requires admin permissions for packages with over 5,000 downloads.Input Parameters
maven: For GitHub’s Gradle registry packages. - container: For Docker images in GitHub’s Container registry (ghcr.io). - docker: For images originally in GitHub’s Docker registry (docker.pkg.github.com), including migrated ones.Output
Delete package version for a user
Delete package version for a user
GITHUB_DELETE_PACKAGE_VERSION_FOR_A_USERDeletes a specific version of a package owned by the specified user. The response indicates whether deletion succeeded; authentication, permission, and not-found errors are returned as unsuccessful results.Input Parameters
maven type. Docker images in GitHub’s Container registry (ghcr.io) use the container type. The docker type can be used for images previously in GitHub’s Docker registry (docker.pkg.github.com), even if migrated.Output
Delete a pending review for a pull request
Delete a pending review for a pull request
Delete a project
Delete a project
GITHUB_DELETE_PROJECTDeletes the specified GitHub project (Projects V2) using the GraphQL API. Note: This action uses GitHub’s Projects V2 GraphQL API. The legacy Projects (classic) REST API was sunset on April 1, 2025 and is no longer available. The project is permanently deleted and cannot be recovered. The user must have admin permissions for the project to delete it.Input Parameters
Output
Delete a project card (Classic - Deprecated)
Delete a project card (Classic - Deprecated)
GITHUB_DELETE_PROJECT_CARDDeletes a project card from a GitHub ‘Project (classic)’; this operation is idempotent. DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. This action may return a 404 error on GitHub.com. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/Input Parameters
Output
Delete a project field (column)
Delete a project field (column)
GITHUB_DELETE_PROJECT_COLUMNDeletes a project field (column) from a GitHub Projects V2 project using the GraphQL API. IMPORTANT: GitHub Classic Projects REST API was sunset on April 1, 2025. This action now uses the GitHub Projects V2 GraphQL API with the deleteProjectV2Field mutation. Note: The built-in Status field cannot be deleted as it is a core field in GitHub Projects V2. Only custom fields can be deleted.Input Parameters
Output
Delete project item for user
Delete project item for user
GITHUB_DELETE_PROJECT_ITEM_FOR_USERTool to delete a project item for a user in GitHub Projects V2. Use when you need to remove an item from a user’s project. Requires the project item’s GraphQL node ID (starts with ‘PVTI_’). Uses the GitHub GraphQL API deleteProjectV2Item mutation.Input Parameters
Output
Delete a pull request comment reaction
Delete a pull request comment reaction
Delete pull request review protection
Delete pull request review protection
GITHUB_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.Input Parameters
Output
Delete repo codespace secret by name
Delete repo codespace secret by name
GITHUB_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.Input Parameters
.git extension. This field is not case-sensitive.Output
Delete team discussion comment reaction
Delete team discussion comment reaction
Delete team discussion reaction
Delete team discussion reaction
Delete User List
Delete User List
Delete a package for a user
Delete a package for a user
GITHUB_DELETE_USER_PACKAGEDeletes a package owned by the specified user, requiring admin permissions for the authenticated user; deletion of public packages with over 5,000 downloads may require GitHub support. A 404 or 422 is returned as an error message rather than raised.Input Parameters
maven. Docker images pushed to GitHub’s Container registry (ghcr.io) use container. The docker type can find images from the old Docker registry (docker.pkg.github.com), even if migrated.Output
Delete workflow run logs
Delete workflow run logs
Disable a custom protection rule for an environment
Disable a custom protection rule for an environment
GITHUB_DISABLE_A_CUSTOM_PROTECTION_RULE_FOR_AN_ENVIRONMENTDisables a specific, currently active custom deployment protection rule for an existing environment within a GitHub repository.Input Parameters
.git extension). This name is not case sensitive./) in the name must be replaced with %2F.Output
Disable a workflow
Disable a workflow
GITHUB_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.Input Parameters
.git extension. This field is not case-sensitive.main.yml or ci.yaml). You can obtain the workflow ID by listing workflows in a repository.Output
Disable private vulnerability reporting for a repository
Disable private vulnerability reporting for a repository
GITHUB_DISABLE_PRIVATE_VULN_REPORTING_FOR_REPODisables private vulnerability reporting for an existing GitHub repository, preventing direct private vulnerability reports to maintainers via GitHub’s interface for this repository.Input Parameters
.git extension. This field is not case-sensitive.Output
Disable Repository Actions In Org
Disable Repository Actions In Org
Dismiss a review for a pull request
Dismiss a review for a pull request
GITHUB_DISMISS_A_REVIEW_FOR_A_PULL_REQUESTDismisses an APPROVED or CHANGES_REQUESTED review on a pull request with a mandatory explanatory message. IMPORTANT: Only reviews in APPROVED or CHANGES_REQUESTED state can be dismissed. Reviews in COMMENTED, PENDING, or already DISMISSED state will return a 422 error. To dismiss a review on a protected branch, you must be a repository admin or be authorized to dismiss pull request reviews.Input Parameters
.git extension. This field is not case-sensitive.Output
Download an artifact
Download an artifact
GITHUB_DOWNLOAD_AN_ARTIFACTDownloads a GitHub Actions workflow artifact as a ZIP file. Returns the artifact as a downloadable file. Use GITHUB_LIST_ARTIFACTS_FOR_A_REPOSITORY or GITHUB_LIST_WORKFLOW_RUN_ARTIFACTS to get valid artifact IDs first.Input Parameters
Output
Download a repository tarball
Download a repository tarball
GITHUB_DOWNLOAD_A_REPOSITORY_ARCHIVE_TARGets a redirect URL for downloading a repository tarball at a specific Git reference. For private repositories, the URL expires after five minutes.Input Parameters
main for the main branch, v1.0.0 for a tag, or a full commit SHA..git extension. The name is not case sensitive.Output
Download a repository archive ZIP
Download a repository archive ZIP
GITHUB_DOWNLOAD_A_REPOSITORY_ARCHIVE_ZIPRequests a ZIP archive of a repository at a specific Git reference (branch, tag, or commit SHA) and returns the redirect URL for downloading it. For private repositories, the URL expires after five minutes.Input Parameters
Output
Download job logs for a workflow run
Download job logs for a workflow run
GITHUB_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.Input Parameters
.git extension. This name is not case-sensitive.Output
Download workflow run attempt logs
Download workflow run attempt logs
GITHUB_DOWNLOAD_WORKFLOW_RUN_ATTEMPT_LOGSDownloads a ZIP archive of logs for a specific workflow run attempt. Returns a downloadable ZIP file containing logs for all jobs and steps in the workflow run.Input Parameters
.git extension. The name is not case sensitive.Output
Download workflow run logs
Download workflow run logs
GITHUB_DOWNLOAD_WORKFLOW_RUN_LOGSDownloads logs for a specific GitHub Actions workflow run as a ZIP archive containing log files for each job in the workflow.Input Parameters
.git extension. This name is not case-sensitive.Output
Enable a workflow
Enable a workflow
GITHUB_ENABLE_A_WORKFLOWReactivates a currently disabled GitHub Actions workflow within a repository using its workflow ID or filename.Input Parameters
.git extension. This value is not case-sensitive.Output
Enable GitHub actions in selected repositories
Enable GitHub actions in selected repositories
GITHUB_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’.Input Parameters
Output
Enable private vulnerability reporting for a repository
Enable private vulnerability reporting for a repository
GITHUB_ENABLE_PRIVATE_VULN_REPORTING_FOR_REPOEnables private vulnerability reporting for a repository, allowing security researchers to privately submit vulnerability reports to maintainers.Input Parameters
.git extension. This field is not case-sensitive.Output
Enable repo for Github Actions
Enable repo for Github Actions
Encrypt and update dev secret
Encrypt and update dev secret
GITHUB_ENCRYPT_AND_UPDATE_DEV_SECRETCreates or updates a repository’s GitHub Codespaces secret. It accepts a plaintext value for automatic encryption or a value already encrypted with the repository’s Codespaces public key.Input Parameters
.git extension. This name is not case-sensitive.GET /repos/{owner}/{repo}/codespaces/secrets/public-key) used to encrypt the secret’s value. If not provided, it will be fetched automatically.GET /repos/{owner}/{repo}/codespaces/secrets/public-key). Use this if you have pre-encrypted the value yourself.Output
Encrypt org dev env secret
Encrypt org dev env secret
GITHUB_ENCRYPT_ORG_DEV_ENV_SECRETCreates or updates an organization’s GitHub Codespaces secret using an encrypted value and its corresponding public key ID.Input Parameters
selected_repository_ids.Output
Export a codespace for the authenticated user
Export a codespace for the authenticated user
Export an SBOM for a repository
Export an SBOM for a repository
GITHUB_EXPORT_SBOM_FOR_REPOExports 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.Input Parameters
.git extension. This field is not case-sensitive.Output
Find Pull Requests
Find Pull Requests
GITHUB_FIND_PULL_REQUESTSSearches pull requests by repository, author, state, labels, merge status, and other filters; without a repository or owner, it searches public repositories by default or PRs involving the authenticated user when requested. Search results are capped at approximately 1,000; creation and update date filters do not filter merge dates.Input Parameters
owner parameter causes invalid repository format errors.order=desc when recency matters; default behavior may return best-match relevance ordering instead.label, state, author) over embedding qualifiers in the query string. Exact title matching is not supported; post-filter on title client-side if needed.page until results fewer than per_page are returned, and add repo, label, or date filters when totals approach 1000.merged_at.Output
Find Repositories
Find Repositories
GITHUB_FIND_REPOSITORIESSearch GitHub repositories by keywords, language, stars, topics, and ownership, returning paginated results. Repository qualifiers are reduced to owner filters, an owner with no public repositories can yield an immediate empty result, and OR expressions are limited to six terms; check incomplete_results for non-exhaustive results.Input Parameters
language, topic, min_stars/max_stars, or owner.repo/read:org; sparse results compared to GitHub UI typically indicate insufficient token scopes.Output
Follow Organization (GraphQL)
Follow Organization (GraphQL)
Follow a user
Follow a user
Follow User (GraphQL)
Follow User (GraphQL)
Force cancel a workflow run
Force cancel a workflow run
GITHUB_FORCE_CANCEL_WORKFLOW_RUNRequests force cancellation of a queued or in-progress GitHub Actions workflow run, bypassing conditions such as always(), when standard cancellation fails. A successful response means the request was accepted for asynchronous processing; completed runs cannot be canceled, and repository write permissions are required.Input Parameters
.git extension. The name is not case sensitive.Output
Fork a gist
Fork a gist
Generate release notes content for a release
Generate release notes content for a release
GITHUB_GENERATE_RELEASE_NOTESGenerates Markdown release notes content (listing changes, pull requests, and contributors) for a GitHub repository release, customizable via tags and a configuration file.Input Parameters
.git extension. This field is not case-sensitive.tag_name does not reference an existing tag. It is ignored if tag_name already exists..github/release.yml) containing settings for generating release notes. If unspecified, GitHub looks for a configuration file at “.github/release.yml” or “.github/release.yaml”. If no such file is found, default settings are used.Output
Get a blob
Get a blob
GITHUB_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.Input Parameters
Output
Get a branch
Get a branch
GITHUB_GET_A_BRANCHRetrieves detailed information for a specified branch within a GitHub repository.Input Parameters
.git extension. The name is not case sensitive.Output
Get access restrictions
Get access restrictions
GITHUB_GET_ACCESS_RESTRICTIONSRetrieves user, team, and GitHub App push restrictions for a protected branch. A 404 is returned as a message indicating that restrictions were not found; it can also mean the branch does not exist or is not protected.Input Parameters
.git extension. This name is not case-sensitive.Output
Get a commit
Get a commit
GITHUB_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.Input Parameters
sha’), a branch name (e.g., ‘heads/BRANCH_NAME’ or simply ‘BRANCH_NAME’), or a tag name (e.g., ‘tags/TAG_NAME’). For more information, see “Git References” in the Git documentation..git extension. This field is not case-sensitive.Output
Get admin branch protection
Get admin branch protection
Get all API versions
Get all API versions
Get all contributor commit activity
Get all contributor commit activity
Get all deployment protection rules for an environment
Get all deployment protection rules for an environment
GITHUB_GET_ALL_DEPLOYMENT_PROTECTION_RULES_FOR_ENVLists all enabled custom deployment protection rules for a specific environment in a repository; the environment must exist and be configured for deployments.Input Parameters
.git extension. This field is not case-sensitive./), they should be replaced with %2F.Output
Get a milestone
Get a milestone
GITHUB_GET_A_MILESTONERetrieves detailed information for a specific milestone within a GitHub repository by its number.Input Parameters
.git extension. This field is not case-sensitive.Output
Get an app
Get an app
Get an artifact
Get an artifact
GITHUB_GET_AN_ARTIFACTGets a specific artifact for a repository by artifact_id. This action retrieves the details of a specific artifact from a GitHub repository using the artifact’s unique identifier. It allows users to access information about artifacts stored in the repository.Input Parameters
.git extension. This field is not case-sensitive.Output
Get an assignment
Get an assignment
Get an autolink reference of a repository
Get an autolink reference of a repository
GITHUB_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.Input Parameters
.git extension. This field is not case-sensitive.Output
Get an environment
Get an environment
GITHUB_GET_AN_ENVIRONMENTRetrieves the details of a specific deployment environment for a given repository, including its name, configurations, and current status.Input Parameters
.git extension. This name is not case-sensitive./ must be replaced with %2F.Output
Get an environment public key
Get an environment public key
GITHUB_GET_AN_ENVIRONMENT_PUBLIC_KEYRetrieves the public key for a specified GitHub repository environment, used to encrypt secrets for GitHub Actions.Input Parameters
.git extension. This field is not case-sensitive./) in the name must be replaced with %2F.Output
Get an environment secret
Get an environment secret
Get an environment variable
Get an environment variable
GITHUB_GET_AN_ENVIRONMENT_VARIABLERetrieves a specific environment variable from a GitHub Actions environment by repository owner, repository name, environment name, and variable name.Input Parameters
/), it must be URL-encoded (e.g., staging/feature becomes staging%2Ffeature).Output
Get an issue
Get an issue
Get an issue comment
Get an issue comment
Get an issue event
Get an issue event
Get an organization public key
Get an organization public key
Get an organization role
Get an organization role
Get an organization secret
Get an organization secret
Get an organization variable
Get an organization variable
Get an organization webhook
Get an organization webhook
Get a package for an organization
Get a package for an organization
GITHUB_GET_A_PACKAGE_FOR_AN_ORGANIZATIONRetrieves a specific package (by type and name) from an organization, if both the package and organization exist.Input Parameters
maven type. Images from ghcr.io (Container registry) use container type. Use docker for images from docker.pkg.github.com (Docker registry), even if migrated to the Container registry.Output
Get a package for a user
Get a package for a user
GITHUB_GET_A_PACKAGE_FOR_A_USERRetrieves metadata for a specific package owned by a GitHub user, using package type, name, and username as identifiers.Input Parameters
Output
Get a package for the authenticated user
Get a package for the authenticated user
GITHUB_GET_A_PACKAGE_FOR_THE_AUTHENTICATED_USERRetrieves detailed information for a specific package owned by the authenticated user.Input Parameters
ghcr.io); ‘docker’ for images from GitHub’s Docker registry (docker.pkg.github.com), including those migrated to the Container registry.Output
Get a package version for an organization
Get a package version for an organization
GITHUB_GET_A_PACKAGE_VERSION_FOR_AN_ORGANIZATIONRetrieves detailed information for a specific version of a package within an organization.Input Parameters
maven for GitHub Gradle registry. container for GitHub Container registry (ghcr.io) images. docker for images from GitHub Docker registry (docker.pkg.github.com), including migrated ones.Output
Get a package version for a user
Get a package version for a user
GITHUB_GET_A_PACKAGE_VERSION_FOR_A_USERRetrieves a specific public package version associated with a GitHub user.Input Parameters
Output
Get authenticated user package version
Get authenticated user package version
GITHUB_GET_A_PACKAGE_VERSION_FOR_THE_AUTHENTICATED_USERRetrieves detailed information for an existing specific package version associated with the authenticated user, identified by its type, name, and version ID.Input Parameters
Output
Get a project
Get a project
GITHUB_GET_A_PROJECTRetrieves detailed information for a specific GitHub project (V2) using its project number and owner. Note: This action uses GitHub’s Projects V2 REST API. The legacy Projects (classic) REST API was sunset on April 1, 2025. The project is identified by its number (visible in the project URL) and owner (either a username or organization name). If no owner is specified, the authenticated user is assumed.Input Parameters
Output
Get a project card
Get a project card
Get a project column (Classic - Deprecated)
Get a project column (Classic - Deprecated)
GITHUB_GET_A_PROJECT_COLUMNRetrieves detailed information for a specific project column from GitHub Projects (classic). DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. This action will return 404 for most requests on GitHub.com. However, it may still work on GitHub Enterprise Server instances where classic projects are enabled. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/ Returns column details including: id, name, url, project_url, cards_url, node_id, created_at, and updated_at timestamps.Input Parameters
Output
Get a pull request
Get a pull request
GITHUB_GET_A_PULL_REQUESTRetrieves a specific pull request from a GitHub repository using its owner, repository name, and pull request number.Input Parameters
Output
Get a reference
Get a reference
GITHUB_GET_A_REFERENCERetrieves a specific Git reference (e.g., a branch, tag, or fully qualified like ‘heads/main’) from a GitHub repository. The reference must exist in the repository; use ‘list_matching_references’ first if unsure what references are available.Input Parameters
heads/<branch_name> for branches, tags/<tag_name> for tags, or pull/<number>/head (or pull/<number>/merge) for pull requests. Simple branch names (e.g., main) are automatically converted to heads/<name>. The reference must exist in the repository; a 404 error is returned if not found. If unsure which references exist, use ‘list_matching_references’ or ‘get_a_branch’ first. Note: Commit SHAs are not supported by this endpoint; use commit-specific endpoints instead. Not all repositories use ‘master’; many now use ‘main’ as the default branch..git extension. This field is not case-sensitive.Output
Get a release
Get a release
GITHUB_GET_A_RELEASEGets a specific release from a GitHub repository, provided the repository is accessible and the release exists.Input Parameters
Output
Get a release asset
Get a release asset
GITHUB_GET_A_RELEASE_ASSETGets metadata for a specific release asset in a GitHub repository, including a browser_download_url for downloading the asset.Input Parameters
.git extension. This name is not case sensitive.Output
Get a release by tag name
Get a release by tag name
Get a repository
Get a repository
Get a repository public key
Get a repository public key
Get a repository readme
Get a repository readme
GITHUB_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.Input Parameters
.git extension. This name is not case-sensitive.Output
Get a repository readme for a directory
Get a repository readme for a directory
Get a repository ruleset
Get a repository ruleset
GITHUB_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.Input Parameters
Output
Get a repository rule suite
Get a repository rule suite
GITHUB_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.Input Parameters
.git extension. This name is not case-sensitive.GET /repos/{owner}/{repo}/rulesets/rule-suites) or organization (e.g., via GET /orgs/{org}/rulesets/rule-suites).Output
Get a repository secret
Get a repository secret
GITHUB_GET_A_REPOSITORY_SECRETGets metadata (name, creation/update timestamps) for an existing repository secret, excluding its encrypted value.Input Parameters
.git extension. This field is not case-sensitive.Output
Get a repository subscription
Get a repository subscription
Get a repository variable
Get a repository variable
Get a repository webhook
Get a repository webhook
GITHUB_GET_A_REPOSITORY_WEBHOOKReturns the configuration of an existing webhook for a given repository.Input Parameters
.git extension. The name is not case-sensitive.X-GitHub-Hook-ID header of a webhook delivery.Output
Get a review comment for a pull request
Get a review comment for a pull request
GITHUB_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.Input Parameters
Output
Get a review for a pull request
Get a review for a pull request
Get a secret for the authenticated user
Get a secret for the authenticated user
Get a self hosted runner for an organization
Get a self hosted runner for an organization
Get a self hosted runner for a repository
Get a self hosted runner for a repository
Get assignment grades
Get assignment grades
Get a tag
Get a tag
Get a team by name
Get a team by name
Get a thread
Get a thread
Get a thread subscription for the authenticated user
Get a thread subscription for the authenticated user
GITHUB_GET_A_THREAD_SUBSCRIPTION_FOR_THE_AUTHENTICATED_USERRetrieves the authenticated user’s subscription details for a specific notification thread, identified by thread_id.Input Parameters
id field returned when retrieving notifications, for example, through the ‘List notifications for the authenticated user’ (GET /notifications) operation.Output
List repository files and directories
List repository files and directories
GITHUB_GET_A_TREEBrowse a GitHub repository’s tree at a specified branch, tag, commit or tree SHA. Recursive mode lists nested entries in one request, but results can be truncated; check the returned truncation flag.Input Parameters
Output
Get a user
Get a user
Get authenticated user organization membership
Get authenticated user organization membership
Get a webhook configuration for an organization
Get a webhook configuration for an organization
Get a webhook configuration for a repository
Get a webhook configuration for a repository
GITHUB_GET_A_WEBHOOK_CONFIGURATION_FOR_A_REPOSITORYReturns the configuration for an existing webhook on the specified repository.Input Parameters
.git extension. The name is not case sensitive.X-GitHub-Hook-ID header of a webhook delivery.Output
Get a webhook delivery for an organization webhook
Get a webhook delivery for an organization webhook
GITHUB_GET_A_WEBHOOK_DELIVERY_FOR_AN_ORGANIZATION_WEBHOOKReturns detailed information for a specific delivery attempt of a webhook configured for the specified GitHub organization.Input Parameters
X-GitHub-Hook-ID header of a webhook delivery.Output
Get a workflow
Get a workflow
Get a workflow run
Get a workflow run
Get a workflow run attempt
Get a workflow run attempt
GITHUB_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.Input Parameters
.git extension. This name is not case sensitive.true, excludes pull request data from the API response; the pull_requests array in the response will then be empty.Output
Get billing usage report for user
Get billing usage report for user
GITHUB_GET_BILLING_USAGE_REPORT_USERRetrieves the billing usage report for a specified GitHub user. Use when you need to analyze billing costs and usage patterns.Input Parameters
day is an integer between 1 and 31. If no year or month is specified, the default year and month are used.year is an integer with four digits representing a year. For example, 2025. Default value is the current year.month is an integer between 1 and 12. If no year is specified the default year is used.Output
Get branch protection
Get branch protection
GITHUB_GET_BRANCH_PROTECTIONRetrieves branch protection settings for a specific accessible branch in a GitHub repository, such as required status checks, review requirements, and push restrictions. Availability varies by GitHub product plan; fine-grained tokens require repository Administration read permission. The branch name cannot contain wildcards.Input Parameters
Output
Get catalog models
Get catalog models
Get a check run
Get a check run
GITHUB_GET_CHECK_RUNRetrieves detailed information for a specific check run within a GitHub repository.Input Parameters
.git extension. This field is not case-sensitive.Output
Get a check suite
Get a check suite
GITHUB_GET_CHECK_SUITERetrieves a specific check suite (a collection of check runs) by its ID from a repository accessible to the authenticated user.Input Parameters
.git extension. This value is not case sensitive.Output
Get a classroom
Get a classroom
Get a code of conduct
Get a code of conduct
Get Code of Conduct (GraphQL)
Get Code of Conduct (GraphQL)
GITHUB_GET_CODE_OF_CONDUCT_GRAPH_QLTool to look up a code of conduct by its key using GitHub’s GraphQL API. Use when you need to fetch code of conduct details as part of a GraphQL workflow.Input Parameters
Output
Get a CodeQL database for a repository
Get a CodeQL database for a repository
GITHUB_GET_CODEQL_DATABASEGets 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.Input Parameters
.git extension. This name is not case-sensitive.Output
Get a code scanning alert
Get a code scanning alert
GITHUB_GET_CODE_SCANNING_ALERTRetrieves a specific code scanning alert, which identifies potential code vulnerabilities or errors, by its number from the specified GitHub repository.Input Parameters
Output
Get a code scanning analysis for a repository
Get a code scanning analysis for a repository
Get a code scanning default setup configuration
Get a code scanning default setup configuration
GITHUB_GET_CODE_SCANNING_DEFAULT_SETUPGets the default setup configuration for code scanning in a repository, including state, languages, query suite, and schedule for a repository if it exists.Input Parameters
.git extension. The name is not case sensitive.Output
Get a codespace for the authenticated user
Get a codespace for the authenticated user
Get a commit comment
Get a commit comment
Get a commit object
Get a commit object
Get commit signature protection
Get commit signature protection
GITHUB_GET_COMMIT_SIGNATURE_PROTECTIONGets the commit signature protection status for a branch in a repository.Input Parameters
.git extension. This name is not case sensitive.Output
Get commit statuses
Get commit statuses
GITHUB_GET_COMMIT_STATUSESLists a page of statuses for a commit reference (SHA, branch, or tag) in reverse chronological order, for checking CI/CD results from various systems.Input Parameters
Output
Get community profile metrics
Get community profile metrics
Get contextual information for a user
Get contextual information for a user
GITHUB_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.Input Parameters
subject_type for more specific hovercard context; required if subject_type is also given.subject_id is also given.Output
Get a custom deployment protection rule
Get a custom deployment protection rule
GITHUB_GET_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.Input Parameters
.git extension. This name is not case sensitive./ must be replaced with %2F).Output
Get default attributes for a codespace
Get default attributes for a codespace
GITHUB_GET_DEFAULT_ATTRIBUTES_FOR_A_CODESPACEGet pre-flight data (e.g., default location, devcontainer path) for creating a Codespace in a given repository (must exist and be accessible), optionally for a specific Git ref.Input Parameters
Output
Get default workflow permissions for an organization
Get default workflow permissions for an organization
Get default workflow permissions for a repository
Get default workflow permissions for a repository
GITHUB_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.Input Parameters
.git extension. This field is not case-sensitive.Output
Get Dependabot alert
Get Dependabot alert
Get a diff of the dependencies between commits
Get a diff of the dependencies between commits
GITHUB_GET_DEPENDENCY_DIFFGets 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.Input Parameters
package-lock.json, pom.xml). If provided, the diff will be scoped to this file..git extension. This field is not case-sensitive.BASE_REF...HEAD_REF. BASE_REF and HEAD_REF can be commit SHAs, branch names, or tags. For example, main...develop or v1.0.0...v1.1.0.Output
Get a deploy key
Get a deploy key
GITHUB_GET_DEPLOY_KEYGets a specific deploy key, identified by its key_id, for the GitHub repository specified by owner and repo.Input Parameters
.git extension. This field is not case-sensitive.Output
Get a deployment
Get a deployment
GITHUB_GET_DEPLOYMENTGets a specific deployment by ID from a repository, provided the repository and deployment ID exist.Input Parameters
Output
Get a deployment branch policy
Get a deployment branch policy
GITHUB_GET_DEPLOYMENT_BRANCH_POLICYRetrieves a specific deployment branch policy for an environment in a repository, identified by its unique ID.Input Parameters
.git extension. This name is not case-sensitive.%2F.Output
Get a deployment status
Get a deployment status
Get details about a codespace export
Get details about a codespace export
Get a discussion
Get a discussion
GITHUB_GET_DISCUSSIONFetches a specific discussion by its number from a team within an organization. This is a read-only action that retrieves discussion details including title, body, author information, comment count, and reactions. The authenticated user must be a member of the organization to access team discussions.Input Parameters
Output
Get a discussion comment
Get a discussion comment
GITHUB_GET_DISCUSSION_COMMENTFetches a specific comment from a team discussion within a specific organization.Input Parameters
Output
Get emojis
Get emojis
Get Enterprise Member Invitation
Get Enterprise Member Invitation
GITHUB_GET_ENTERPRISE_MEMBER_INVITATIONTool to look up a pending enterprise unaffiliated member invitation by invitee and enterprise. Use when you need to check the status of a specific invitation.Input Parameters
Output
Get feeds
Get feeds
Get a gist
Get a gist
Get a gist comment
Get a gist comment
GITHUB_GET_GIST_COMMENTRetrieves a specific GitHub Gist comment using the gist ID and comment ID, returning its text, author information, and timestamps.Input Parameters
Output
Get a gist revision
Get a gist revision
Get GitHub Actions cache usage for an organization
Get GitHub Actions cache usage for an organization
Get github actions cache usage for a repository
Get github actions cache usage for a repository
GITHUB_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.Input Parameters
.git extension. This field is not case-sensitive.Output
Get github actions permissions for an organization
Get github actions permissions for an organization
Get GitHub Actions permissions for a repository
Get GitHub Actions permissions for a repository
Get billing usage summary for user
Get billing usage summary for user
GITHUB_GET_GITHUB_BILLING_USAGE_SUMMARY_FOR_USERTool to retrieve billing usage summary for a GitHub user account. Use when tracking usage costs, monitoring billing details, or generating usage reports for a specific user. Note: This endpoint only returns data for the past 24 months and is currently in public preview.Input Parameters
Output
Get github meta information
Get github meta information
Get github pages build
Get github pages build
GITHUB_GET_GITHUB_PAGES_BUILDRetrieves detailed information about a specific GitHub Pages build for a repository, which must have GitHub Pages enabled.Input Parameters
.git extension. This field is not case-sensitive.Output
Get a gitignore template
Get a gitignore template
Get a global security advisory
Get a global security advisory
Fetch GraphQL Node
Fetch GraphQL Node
GITHUB_GET_GRAPHQL_NODEFetch a GitHub GraphQL node by its global ID. By default, only its ID is requested; supply a GraphQL fragment to retrieve additional fields.Input Parameters
Output
Get GraphQL rate limit
Get GraphQL rate limit
GITHUB_GET_GRAPHQL_RATE_LIMITTool to retrieve the authenticated client’s GitHub GraphQL API rate limit information. Use when you need to check remaining quota, current usage, or reset time for GraphQL requests.Input Parameters
Output
Get information about a sarif upload
Get information about a sarif upload
GITHUB_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.Input Parameters
Output
Get interaction restrictions for an organization
Get interaction restrictions for an organization
Get interaction restrictions for a repository
Get interaction restrictions for a repository
Get interaction restrictions for public repositories
Get interaction restrictions for public repositories
Get issue comments
Get issue comments
Get a label
Get a label
GITHUB_GET_LABELRetrieves a specific label by its name from a specified GitHub repository.Input Parameters
.git extension. The name is not case-sensitive.Output
Get large files
Get large files
GITHUB_GET_LARGE_FILESLists files larger than 100MB identified during a previous source import for the specified repository. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports.Input Parameters
.git extension. This field is not case-sensitive.Output
Get latest pages build
Get latest pages build
GITHUB_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.Input Parameters
Output
Get a license
Get a license
Get License (GraphQL)
Get License (GraphQL)
GITHUB_GET_LICENSE_GRAPH_QLTool to look up an open source license by its SPDX ID using GitHub’s GraphQL API. Use when you need to fetch license details for compliance tracking or repository setup.Input Parameters
Output
Get octocat
Get octocat
Customize OIDC subject claim template
Customize OIDC subject claim template
GITHUB_GET_OIDC_SUBJECT_CLAIM_TEMPLATERetrieves the OpenID Connect (OIDC) subject claim customization template for a repository’s GitHub Actions workflows. The validated response has no declared template fields.Input Parameters
.git extension. This field is not case-sensitive.Output
Get allowed actions and workflows for an org
Get allowed actions and workflows for an org
Get organization audit log
Get organization audit log
GITHUB_GET_ORGANIZATION_AUDIT_LOGTool to retrieve an organization’s audit log events for security and compliance investigations. Use when tracking organizational changes, security audits, or compliance monitoring. Requires organization owner permissions and read:audit_log scope.Input Parameters
Output
Get a custom property for an organization
Get a custom property for an organization
Get organization membership for user
Get organization membership for user
Get organization project item
Get organization project item
GITHUB_GET_ORGANIZATION_PROJECT_ITEMTool to get an item from an organization-owned GitHub Projects V2 project. Use when you need to retrieve details about a specific project item including its content, fields, timestamps, and creator information.Input Parameters
Output
Get organization public key for Codespaces secrets
Get organization public key for Codespaces secrets
Fetch Public Key For Secret Encryption
Fetch Public Key For Secret Encryption
GITHUB_GET_ORGANIZATION_PUBLIC_KEY_FOR_DEPENDABOTRetrieves the public key for an existing GitHub organization, required for encrypting Dependabot secrets. Requires admin:org scope.Input Parameters
Output
Get organization teams
Get organization teams
GITHUB_GET_ORGANIZATION_TEAMSRetrieves a list of teams for a specified GitHub organization. Use this action when you need to list all teams, find team information, or explore team structure within an organization. Requires read:org scope and returns paginated results.Input Parameters
Output
Get org dev environment secret safely
Get org dev environment secret safely
Get custom OIDC subject claim template
Get custom OIDC subject claim template
GITHUB_GET_ORG_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.Input Parameters
Output
Get a dns health check for github pages
Get a dns health check for github pages
GITHUB_GET_PAGES_DNS_HEALTH_CHECKRetrieves the DNS health check status (e.g., CNAME/A records, HTTPS) for a GitHub Pages site; the check may be pending (HTTP 202) on initial calls or after site changes.Input Parameters
.git extension. This field is not case sensitive.Output
Get a GitHub Pages site
Get a GitHub Pages site
GITHUB_GET_PAGES_SITERetrieves information for a GitHub Pages site, which must be enabled for the repository.Input Parameters
.git extension. This field is not case-sensitive.Output
Get page views
Get page views
Get parent issue
Get parent issue
Get pending deployments for a workflow run
Get pending deployments for a workflow run
Get project permission for a user
Get project permission for a user
GITHUB_GET_PROJECT_PERMISSION_FOR_A_USERRetrieves permission information for a GitHub project (classic) collaborator. Returns the permission level and may include the collaborator’s GitHub user information.Input Parameters
Output
Get public key for secret encryption
Get public key for secret encryption
GITHUB_GET_PUBLIC_KEY_FOR_SECRET_ENCRYPTIONRetrieves a repository’s public key for encrypting GitHub Codespaces secrets. For private repositories, classic OAuth or personal access tokens need the repo scope; fine-grained tokens need write permission for repository Codespaces secrets.Input Parameters
Output
Get public key for the authenticated user
Get public key for the authenticated user
Get pull request review protection
Get pull request review protection
GITHUB_GET_PULL_REQUEST_REVIEW_PROTECTIONRetrieves the pull request review protection settings for a specific branch in a GitHub repository, if such protection is configured.Input Parameters
.git extension. This name is not case-sensitive. For example, in ‘octocat/Hello-World’, ‘Hello-World’ is the repository name.Output
Get Pull Requests
Get Pull Requests
GITHUB_GET_PULL_REQUESTSRetrieves a page of pull requests from a repository, optionally filtered by state, base branch, or head branch and sorted by the selected order. Returns pull request details including title, state, author, labels, timestamps, and branch information.Input Parameters
user:ref-name or organization:ref-name. For example: github:new-script-format or octocat:test-branch..git extension. The name is not case sensitive.popularity will sort by the number of comments. long-running will sort by date created and will limit the results to pull requests that have been open for more than a month and have had activity within the past month.Output
Get rate limit status for the authenticated user
Get rate limit status for the authenticated user
Get Raw Repository Content
Get Raw Repository Content
GITHUB_GET_RAW_REPOSITORY_CONTENTFetches raw file content from a GitHub repository as a downloadable file, without parsing or validating its format. Ensure owner, repo, ref, and path are consistent when combining with other GitHub tools.Input Parameters
Output
Get allowed actions and workflows for a repository
Get allowed actions and workflows for a repository
GITHUB_GET_REPO_ALLOWED_ACTIONSGets the settings for allowed actions and reusable workflows in a repository. Requires the repository’s allowed_actions policy to be set to selected (returns 409 if set to all or local_only).Input Parameters
.git extension. This field is not case-sensitive.Output
Get repository development environment secret
Get repository development environment secret
GITHUB_GET_REPO_DEV_ENV_SECRETGets metadata (name, creation/update timestamps) for a specific, existing development environment secret (Codespaces secret) in a repository, without exposing its value.Input Parameters
.git extension. This field is case-insensitive.Output
Get repository attestations
Get repository attestations
GITHUB_GET_REPOS_ATTESTATIONSTool to retrieve attestations by subject digest from a GitHub repository. Use when you need to verify or check attestations for a specific artifact identified by its SHA256 digest.Input Parameters
.git extension. The name is not case sensitive.provenance, sbom, release, or freeform text for custom predicate types.sha256:HEX_DIGEST.Output
Get repository clones
Get repository clones
GITHUB_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.Input Parameters
day for daily clone counts, or week for weekly clone counts (a week starts on Monday).Output
Get repository content
Get repository content
GITHUB_GET_REPOSITORY_CONTENTRetrieves a file’s Base64-encoded content or lists a directory’s contents in a GitHub repository. Specify a branch, tag, or commit to read from, or use the repository’s default branch; an empty path lists the root directory.Input Parameters
ref parameter. Path should be file/directory path only (e.g., ‘src/main.js’, ‘README.md’), NOT prefixed with branch name (use ‘src/main.js’ not ‘main/src/main.js’). File paths must include extension (e.g., ‘README.md’, not ‘README’). For common files (README, LICENSE, CHANGELOG) without extensions, action auto-tries common extensions (.md, .txt, .rst). Paths are case-sensitive. On 404 errors, list parent directory to verify exact path/casing..git extension. This name is not case sensitive.Output
Get repository Discussion thread
Get repository Discussion thread
Get Repository via GraphQL
Get Repository via GraphQL
Get Repository Owner
Get Repository Owner
GITHUB_GET_REPOSITORY_OWNERTool to lookup a repository owner (User or Organization) by login using GitHub’s GraphQL API. Use when you need to determine whether a login is a user or organization and retrieve basic profile information.Input Parameters
Output
Get repository permissions for a user
Get repository permissions for a user
Retrieve repo public key for encryption
Retrieve repo public key for encryption
Get repository secret securely
Get repository secret securely
GITHUB_GET_REPOSITORY_SECRET_SECURELYRetrieves metadata for an existing Dependabot secret in a repository, without exposing its encrypted value.Input Parameters
.git extension. This field is not case-sensitive.Output
Get repository security advisory
Get repository security advisory
GITHUB_GET_REPOSITORY_SECURITY_ADVISORYTool to retrieve a repository security advisory using its GHSA identifier. Use when you need detailed information about a specific security vulnerability.Input Parameters
.git extension. The name is not case sensitive.Output
Get repository star history
Get repository star history
Get a delivery for a repository webhook
Get a delivery for a repository webhook
GITHUB_GET_REPOSITORY_WEBHOOK_DELIVERYRetrieves a specific delivery for a repository webhook, identified by its hook_id and delivery_id.Input Parameters
.git extension. The name is not case sensitive.X-GitHub-Hook-ID header of a webhook delivery, or by listing repository webhooks.Output
Get rules for a branch
Get rules for a branch
GITHUB_GET_RULES_FOR_A_BRANCHRetrieves a page of active rules for a specific branch in a GitHub repository, excluding rules in ‘evaluate’ or ‘disabled’ status.Input Parameters
.git extension. This name is not case-sensitive.Output
Get Organization Dependabot Secret
Get Organization Dependabot Secret
Get status checks protection
Get status checks protection
GITHUB_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.Input Parameters
.git extension. This field is not case-sensitive.Output
Get team members
Get team members
GITHUB_GET_TEAM_MEMBERSRetrieves one page of members for a specific team within an organization, including members of child teams, optionally filtered by role. Requires the authenticated user to have read access to the team.Input Parameters
Output
Get team membership for a user
Get team membership for a user
Get teams with access to the protected branch
Get teams with access to the protected branch
GITHUB_GET_TEAMS_WITH_ACCESS_TO_THE_PROTECTED_BRANCHLists teams with explicit push access to a protected branch. A 404 response is returned as an empty teams list, which can also reflect a missing branch or absent branch protection.Input Parameters
Output
Get the authenticated user
Get the authenticated user
Get the combined status for a specific reference
Get the combined status for a specific reference
GITHUB_GET_THE_COMBINED_STATUS_FOR_A_SPECIFIC_REFERENCERetrieves the combined commit status and status entries for a specific reference (SHA, branch, or tag) in a GitHub repository.Input Parameters
heads/main), or a tag name (e.g., tags/v1.0.0). See “Git References” for more details..git extension. This field is not case-sensitive.Output
Get the hourly commit count for each day
Get the hourly commit count for each day
GITHUB_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.Input Parameters
.git extension. The name is not case sensitive.Output
Get the last year of commit activity
Get the last year of commit activity
GITHUB_GET_THE_LAST_YEAR_OF_COMMIT_ACTIVITYFetches weekly commit totals and daily commit counts for the last 52 weeks for a specified GitHub repository.Input Parameters
.git extension. This field is not case-sensitive.Output
Get the latest release
Get the latest release
GITHUB_GET_THE_LATEST_RELEASEFetches the latest official (non-prerelease, non-draft) release for a GitHub repository; requires at least one such published release.Input Parameters
.git extension. This field is not case-sensitive.Output
Get the license for a repository
Get the license for a repository
GITHUB_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).Input Parameters
refs/heads/<branch_name> or simply <branch_name>. To reference a pull request’s merge commit, use refs/pull/<pull_number>/merge. If omitted, the license from the repository’s default branch is used..git extension. This field is not case-sensitive.Output
Get the review history for a workflow run
Get the review history for a workflow run
GITHUB_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.Input Parameters
.git extension. This name is not case-sensitive.Output
Get the status of a GitHub Pages deployment
Get the status of a GitHub Pages deployment
GITHUB_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.Input Parameters
.git extension. This field is not case-sensitive.Output
Get the weekly commit activity
Get the weekly commit activity
GITHUB_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.Input Parameters
.git extension. This name is not case-sensitive.Output
Get the weekly commit count
Get the weekly commit count
GITHUB_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.Input Parameters
.git extension. This name is not case-sensitive.Output
Get the Zen of GitHub
Get the Zen of GitHub
Get top referral paths
Get top referral paths
Get top referral sources
Get top referral sources
GITHUB_GET_TOP_REFERRAL_SOURCESFetches the top 10 websites that referred traffic to a repository within the last 14 days.Input Parameters
.git extension. This field is case-insensitive.Output
Get user by ID
Get user by ID
Get user project item
Get user project item
GITHUB_GET_USER_PROJECT_ITEMTool to get an item from a user-owned project in GitHub Projects V2. Use when you need to retrieve details about a specific item (issue, pull request, or draft issue) in a user’s project board.Input Parameters
Output
Get user attestations by subject digest
Get user attestations by subject digest
GITHUB_GET_USERS_ATTESTATIONSRetrieves attestations for a GitHub user and subject digest, with optional predicate filtering and pagination. A GitHub 404 is returned as an empty attestation list.Input Parameters
Output
Get user's projects v2
Get user's projects v2
GITHUB_GET_USERS_PROJECTS_V2Tool to list GitHub Projects v2 for a specified user. Use when you need to retrieve all projects owned by a user with pagination support.Input Parameters
Output
Get users with access to the protected branch
Get users with access to the protected branch
GITHUB_GET_USERS_WITH_ACCESS_TO_THE_PROTECTED_BRANCHLists users with explicit push access to a protected branch through its push restrictions. A 404 response is returned as an empty user list, including when the branch or repository is inaccessible or missing.Input Parameters
.git extension. This name is not case-sensitive.Output
Get Viewer via GraphQL
Get Viewer via GraphQL
Get workflow external access level
Get workflow external access level
GITHUB_GET_WORKFLOW_EXTERNAL_ACCESSGets the access level settings for a private repository, determining how workflows outside this repository can use its actions and reusable workflows.Input Parameters
.git extension. This name is not case-sensitive.Output
Get a job for a workflow run
Get a job for a workflow run
GITHUB_GET_WORKFLOW_RUN_JOBRetrieves 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.Input Parameters
.git extension. This field is not case-sensitive.Output
Get workflow run usage
Get workflow run usage
Get workflow usage
Get workflow usage
GITHUB_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.Input Parameters
.git extension. This field is not case-sensitive.Output
Check if repo starred by auth user
Check if repo starred by auth user
GITHUB_IS_REPOSITORY_STARRED_BY_THE_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.g., HTTP 404) if the repository is not starred or does not exist.Input Parameters
.git extension. This name is not case sensitive.Output
List accepted assignments for an assignment
List accepted assignments for an assignment
GITHUB_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.Input Parameters
Output
List repositories accessible via GitHub App installation
List repositories accessible via GitHub App installation
GITHUB_LIST_ACCESSIBLE_REPOSITORIESLists repositories that the authenticated user can access through a specific GitHub App installation. Returns repositories where the user has explicit :read, :write, or :admin permission through the installation. The response includes permission details for each repository. Prerequisites: - Requires a GitHub App user access token (not a standard OAuth token) - Use GITHUB_LIST_APP_INSTALLATIONS first to get valid installation IDsInput Parameters
Output
List app installations for user token
List app installations for user token
Get apps with access to the protected branch
Get apps with access to the protected branch
GITHUB_LIST_APPS_WITH_ACCESS_TO_THE_PROTECTED_BRANCHLists GitHub Apps with push access to a repository’s protected branch. A 404 returns no app list and an explanatory message; it can indicate a missing branch or unavailable restrictions.Input Parameters
Output
List artifacts for a repository
List artifacts for a repository
GITHUB_LIST_ARTIFACTS_FOR_A_REPOSITORYLists GitHub Actions workflow artifacts for a specified repository, which must exist.Input Parameters
.git extension. This field is not case-sensitive.Output
List assignees
List assignees
List assignments for a classroom
List assignments for a classroom
GITHUB_LIST_ASSIGNMENTS_FOR_A_CLASSROOMLists a page of assignments for an accessible GitHub Classroom, with page and page-size controls.Input Parameters
Output
List attestation repositories
List attestation repositories
GITHUB_LIST_ATTESTATION_REPOSITORIESTool to list attestation repositories for an organization. Use when you need to discover which repositories in an organization have attestations. Attestations provide verifiable metadata about software artifacts.Input Parameters
Output
List authenticated user SSH keys
List authenticated user SSH keys
List available machine types for a repository
List available machine types for a repository
GITHUB_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.Input Parameters
.git extension. The name is not case sensitive.location is not specified. This is particularly useful when requests are proxied, to ensure location-based machine availability is accurate.Output
List branches
List branches
GITHUB_LIST_BRANCHESLists a page of branches in a GitHub repository, optionally filtered by protection status. Returns branch names, commit information, and protection status.Input Parameters
.git extension. The name is not case sensitive.true returns only branches protected by branch protections or rulesets. When set to false, only unprotected branches are returned. Omitting this parameter returns all branches.Output
List branches for head commit
List branches for head commit
GITHUB_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.Input Parameters
.git extension. This name is not case-sensitive.Output
List check run annotations
List check run annotations
GITHUB_LIST_CHECK_RUN_ANNOTATIONSLists annotations for a specific check run in a GitHub repository, detailing issues like errors or warnings on particular code lines.Input Parameters
.git extension. The name is not case sensitive.Output
List check runs for a git ref
List check runs for a git ref
GITHUB_LIST_CHECK_RUNS_FOR_A_REFList GitHub check runs for a commit SHA, branch, or tag to assess CI status and conclusions. Results default to the latest runs; the filter can be set to include all runs.Input Parameters
Output
List check runs in a check suite
List check runs in a check suite
GITHUB_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. Results default to the latest runs; the filter can be set to include all runs.Input Parameters
completed_at timestamp: ‘latest’ for most recent, ‘all’ for all check runs.Output
List check suites for a git reference
List check suites for a git reference
GITHUB_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.Input Parameters
heads/BRANCH_NAME or BRANCH_NAME, or tag name like tags/TAG_NAME or TAG_NAME) to list check suites for..git extension. This name is not case-sensitive.id of the GitHub App that created them. If omitted, check suites from all apps are returned.Output
List child teams
List child teams
List classrooms
List classrooms
List codeowners errors
List codeowners errors
GITHUB_LIST_CODEOWNERS_ERRORSLists syntax errors in a repository’s CODEOWNERS file, which must be located at the root, .github/, or docs/ directory for the specified ref.Input Parameters
Output
List CodeQL databases for a repository
List CodeQL databases for a repository
List code scanning alerts for an organization
List code scanning alerts for an organization
GITHUB_LIST_CODE_SCANNING_ALERTS_FOR_AN_ORGANIZATIONLists code scanning alerts for a GitHub organization; use either tool name or tool GUID when filtering by tool. Some access or scanning errors return an empty alert list with a message.Input Parameters
tool_name.Output
List code scanning alerts for a repository
List code scanning alerts for a repository
GITHUB_LIST_CODE_SCANNING_ALERTS_FOR_A_REPOSITORYLists code scanning alerts for a repository, optionally filtering by tool, Git reference, state, or severity. Some scanning or authorization errors return an empty alert list with a message rather than an error.Input Parameters
refs/pull/42/merge) for retrieving alerts; defaults to the repository’s default branch if unspecified.created (alert creation time) or updated (last update time).tool_guid or tool_name, not both. Some tools may not provide a GUID.tool_name or tool_guid, not both.Output
List code scanning analyses for a repository
List code scanning analyses for a repository
GITHUB_LIST_CODE_SCANNING_ANALYSES_FOR_A_REPOSITORYLists code scanning analyses for a repository, optionally filtering by tool, Git reference, or SARIF ID. Some scanning and access errors return an empty list without an explanatory message.Input Parameters
.git extension. This name is not case-sensitive.tool_name.tool_guid.Output
Get all codes of conduct
Get all codes of conduct
List Codes of Conduct (GraphQL)
List Codes of Conduct (GraphQL)
List codespaces for a user in organization
List codespaces for a user in organization
List codespaces for the authenticated user
List codespaces for the authenticated user
GITHUB_LIST_CODESPACES_FOR_THE_AUTHENTICATED_USERLists GitHub Codespaces for the authenticated user, optionally filtering by repository ID and supporting pagination.Input Parameters
Output
List codespaces for the organization
List codespaces for the organization
GITHUB_LIST_CODESPACES_FOR_THE_ORGANIZATIONLists active/pending GitHub Codespaces for an existing organization; admins list all, members list their own.Input Parameters
Output
List comment changes across organization
List comment changes across organization
GITHUB_LIST_COMMENT_CHANGESTool to list issue and PR comment changes across an organization’s repositories efficiently. Use when monitoring comment activity without per-PR/per-issue polling. Filters organization events to return only comment-related events (IssueCommentEvent, PullRequestReviewCommentEvent, CommitCommentEvent). Note: Events are limited to the past 30 days and up to 300 events per timeline. Use ETag header for efficient polling to avoid rate limits.Input Parameters
Output
List comments for a pull request review
List comments for a pull request review
GITHUB_LIST_COMMENTS_FOR_A_PULL_REQUEST_REVIEWLists a page of comments for a specific review on a GitHub pull request, with pagination support.Input Parameters
.git extension. This field is not case-sensitive.Output
List commit comments
List commit comments
GITHUB_LIST_COMMIT_COMMENTSRetrieves a page of comments for a specific commit in a GitHub repository, supporting pagination.Input Parameters
.git extension. This name is not case-sensitive.Output
List commit comments for a repository
List commit comments for a repository
List commits
List commits
GITHUB_LIST_COMMITSLists a page of commits for a GitHub repository, optionally filtered by SHA or branch, path, author, committer, or date range. The default page size is one commit.Input Parameters
main or master)..git extension (repository name only, not the full ‘owner/repo’ path). Must contain only alphanumeric characters, hyphens (-), underscores (_), and periods (.). Wildcards like ’*’ are not supported.YYYY-MM-DDTHH:MM:SSZ.YYYY-MM-DDTHH:MM:SSZ.Output
List commits on a pull request
List commits on a pull request
Get all commonly used licenses
Get all commonly used licenses
GITHUB_LIST_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.Input Parameters
Output
Get all custom properties for an organization
Get all custom properties for an organization
GITHUB_LIST_CUSTOM_PROPERTIES_FOR_AN_ORGANIZATIONGets the schema definitions for an organization’s custom properties, rather than repository-specific values. On non-200 responses, it returns an empty property list alongside an error and status code.Input Parameters
Output
Get all custom property values for a repository
Get all custom property values for a repository
GITHUB_LIST_CUSTOM_PROPERTY_VALUES_FOR_A_REPOSITORYGets all custom property values for a repository. Custom properties are defined at the organization level, so this endpoint works with organization-owned repositories. Returns an empty array if no custom properties are set.Input Parameters
.git extension. This field is not case-sensitive.Output
List custom property values for organization repositories
List custom property values for organization repositories
GITHUB_LIST_CUSTOM_PROPERTY_VALUES_FOR_ORG_REPOSLists repositories in an organization with their custom property values. Requires ‘Custom properties’ organization permission (read).Input Parameters
Output
List deliveries for an organization webhook
List deliveries for an organization webhook
List deliveries for a repository webhook
List deliveries for a repository webhook
GITHUB_LIST_DELIVERIES_FOR_A_REPOSITORY_WEBHOOKRetrieves delivery attempts for a specific repository webhook to inspect its history; ensure the webhook ID exists.Input Parameters
.git extension. This field is case-insensitive.Link header in the response provides cursors for the next and previous pages.X-GitHub-Hook-ID header of a webhook delivery.true, the response will include the latest redelivery attempt for each delivery, rather than the original delivery.Output
List deploy keys
List deploy keys
List deployment branch policies
List deployment branch policies
List deployments
List deployments
GITHUB_LIST_DEPLOYMENTSLists deployments for a specified repository; repository must exist.Input Parameters
.git extension. This name is not case sensitive.Output
List deployment statuses
List deployment statuses
List discussion comments
List discussion comments
List discussions
List discussions
GITHUB_LIST_DISCUSSIONSLists a page of discussions for a specific team within an organization, with sorting and pinned-status filtering; team discussions are deprecated. A 404 response is returned as an empty list, so an empty result does not necessarily mean there are no discussions.Input Parameters
Output
List email addresses for the authenticated user
List email addresses for the authenticated user
List environment custom deployment rules
List environment custom deployment rules
GITHUB_LIST_ENVIRONMENT_CUSTOM_DEPLOYMENT_RULESLists a page of custom deployment protection rule integrations available for a GitHub repository environment. The caller must have repository admin or owner permissions; pagination supports up to 100 results per page.Input Parameters
/ replaced with %2F).Output
List environments
List environments
GITHUB_LIST_ENVIRONMENTSRetrieves a page of deployment environments for a specified repository, which are used to configure protection rules and secrets for different software lifecycle stages.Input Parameters
.git extension. This field is not case-sensitive.Output
List environment secrets
List environment secrets
List environment variables
List environment variables
GITHUB_LIST_ENVIRONMENT_VARIABLESLists a page of plaintext GitHub Actions environment variables for a specified environment within a repository.Input Parameters
.git extension. This name is not case-sensitive./ in the name must be replaced with %2F.Output
List events for the authenticated user
List events for the authenticated user
List events for user
List events for user
GITHUB_LIST_EVENTS_FOR_USERLists events performed by a GitHub user in reverse chronological order. If authenticated as the specified user, you will see private events; otherwise, only public events are returned. Use this action when you need to retrieve a user’s activity history, such as commits, pull requests, issues, and other GitHub actions.Input Parameters
Output
List events received by the authenticated user
List events received by the authenticated user
GITHUB_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.Input Parameters
Output
List followers of a user
List followers of a user
List followers of the authenticated user
List followers of the authenticated user
List following for user
List following for user
GITHUB_LIST_FOLLOWING_FOR_USERLists the people that a GitHub user follows. Use this action when you need to retrieve the list of users that a specific GitHub user is following. The response includes public profile information for each followed user with pagination support.Input Parameters
Output
List forks
List forks
GITHUB_LIST_FORKSLists forks for a specified repository, which must exist, with options for sorting and pagination.Input Parameters
.git extension. This field is not case-sensitive.stargazers sorts by the number of stars. Defaults to newest.Output
List gist comments
List gist comments
List gist commits
List gist commits
List gist forks
List gist forks
GITHUB_LIST_GIST_FORKSLists a page of forks for a given GitHub gist ID, with pagination controls.Input Parameters
Output
List gists for a user
List gists for a user
List gists for the authenticated user
List gists for the authenticated user
List github actions caches for a repository
List github actions caches for a repository
GITHUB_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.Input Parameters
refs/heads/<branch_name> or refs/pull/<pull_request_number>/merge).created_at (creation time), last_accessed_at (last access time), or size_in_bytes (cache size).Output
List GitHub Pages builds
List GitHub Pages builds
GITHUB_LIST_GITHUB_PAGES_BUILDSLists GitHub Pages builds for a repository; GitHub Pages must be enabled on the repository for builds to be listed.Input Parameters
.git extension. This name is not case-sensitive.Output
Get all gitignore templates
Get all gitignore templates
List global security advisories
List global security advisories
GITHUB_LIST_GLOBAL_SECURITY_ADVISORIESLists GitHub’s global security advisories, filterable by ID, type, ecosystem, severity, dates, and other attributes. The advisory type defaults to reviewed.Input Parameters
affects=pkg1,pkg2@1.0.0.Output
List GPG keys for a user
List GPG keys for a user
GITHUB_LIST_GPG_KEYS_FOR_A_USERTool to list GPG keys for a GitHub user. Use when you need to fetch the public GPG keys associated with a specific GitHub user account.Input Parameters
Output
List installation requests for the authenticated app
List installation requests for the authenticated app
List instances of a code scanning alert
List instances of a code scanning alert
GITHUB_LIST_INSTANCES_OF_A_CODE_SCANNING_ALERTLists a page of instances of a specific code scanning alert, optionally filtered by Git ref. Some access or repository-state errors are returned as an empty instance list with an explanatory message.Input Parameters
ref for a branch can be formatted either as refs/heads/<branch name> or simply <branch name>. To reference a pull request use refs/pull/<number>/merge..git extension. The name is not case sensitive.number field in the response from the GET /repos/{owner}/{repo}/code-scanning/alerts operation.Output
List issue comments
List issue comments
List issue comments for a repository
List issue comments for a repository
GITHUB_LIST_ISSUE_COMMENTS_FOR_A_REPOSITORYLists issue comments, including those on pull requests, for an accessible repository.Input Parameters
.git extension. This is a path parameter needed to construct the API URL. This field is not case-sensitive.created (for creation date, default) or updated (for last update date).YYYY-MM-DDTHH:MM:SSZ).asc (ascending) or desc (descending). This parameter is effective only when sort is also specified.Output
List issue dependencies blocked by
List issue dependencies blocked by
GITHUB_LIST_ISSUE_DEPENDENCIES_BLOCKED_BYLists a page of issues that block a specified GitHub issue.Input Parameters
.git extension. The name is not case sensitive.Output
List issue dependencies blocking
List issue dependencies blocking
GITHUB_LIST_ISSUE_DEPENDENCIES_BLOCKINGTool to list dependencies an issue is blocking. Use when you need to see which issues are blocked by a specific issue.Input Parameters
.git extension. The name is not case sensitive.Output
List issue events
List issue events
GITHUB_LIST_ISSUE_EVENTSRetrieves a page of issue events for a specific issue within a GitHub repository.Input Parameters
.git extension. This name is not case-sensitive.Output
List issue events for a repository
List issue events for a repository
GITHUB_LIST_ISSUE_EVENTS_FOR_A_REPOSITORYLists a page of issue events, such as closed, reopened, and assigned events, for a specified repository.Input Parameters
Output
List issues for user
List issues for user
GITHUB_LIST_ISSUES_ASSIGNED_TO_THE_AUTHENTICATED_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.Input Parameters
Output
List issue types
List issue types
List jobs for a workflow run
List jobs for a workflow run
GITHUB_LIST_JOBS_FOR_A_WORKFLOW_RUNLists jobs for a specific workflow run in a GitHub repository.Input Parameters
completed_at timestamp. latest returns jobs from the most recent execution attempt of the workflow run. all returns all jobs for a workflow run, including from previous execution attempts.Output
List jobs for a workflow run attempt
List jobs for a workflow run attempt
List labels for an issue
List labels for an issue
GITHUB_LIST_LABELS_FOR_AN_ISSUELists a page of labels for a specified issue in a GitHub repository, with pagination controls.Input Parameters
Output
List labels for a repository
List labels for a repository
List labels for a self-hosted runner for a repository
List labels for a self-hosted runner for a repository
GITHUB_LIST_LABELS_FOR_A_SELF_HOSTED_RUNNER_FOR_A_REPOSITORYLists all labels assigned to a specific self-hosted runner registered with the given repository.Input Parameters
Output
List labels for issues in a milestone
List labels for issues in a milestone
GITHUB_LIST_LABELS_FOR_ISSUES_IN_A_MILESTONELists a page of labels for issues within a specific milestone in a repository.Input Parameters
Output
List labels for a self-hosted runner for an organization
List labels for a self-hosted runner for an organization
List Licenses (GraphQL)
List Licenses (GraphQL)
List machine types for a codespace
List machine types for a codespace
GITHUB_LIST_MACHINE_TYPES_FOR_A_CODESPACELists available machine types for a specific, accessible codespace, enabling it to be transitioned to a new hardware configuration.Input Parameters
Output
List matching references
List matching references
GITHUB_LIST_MATCHING_REFERENCESLists a page of Git references, such as branches or tags, in a repository that start with the provided partial reference path.Input Parameters
refs/ prefix.Output
List milestones
List milestones
GITHUB_LIST_MILESTONESLists milestones, which track progress for groups of issues and pull requests, for an existing repository, allowing filtering by state and sorting.Input Parameters
due_on (due date) or completeness (percentage of issues completed).Output
List notifications for authenticated user
List notifications for authenticated user
GITHUB_LIST_NOTIFICATIONSTool to list notification threads for the authenticated user with efficient polling support. Use when you need to fetch the user’s GitHub notification inbox with filters like unread/participating/since. Returns notification threads plus polling headers (Last-Modified, ETag, X-Poll-Interval) for efficient polling. IMPORTANT: This endpoint requires a Personal Access Token (classic) with ‘notifications’ or ‘repo’ scope. It does NOT work with GitHub App tokens or fine-grained personal access tokens. If the token type is incompatible, a clear error message will be returned.Input Parameters
Output
List notifications for the authenticated user (Deprecated)
List notifications for the authenticated user (Deprecated)
GITHUB_LIST_NOTIFICATIONS_FOR_THE_AUTHENTICATED_USERDEPRECATED: Use GITHUB_LIST_NOTIFICATIONS instead. Lists notifications for the authenticated user, sorted by most recent update, with filtering and pagination options.Input Parameters
true, shows only notifications in which the authenticated user is directly participating or has been mentioned.Output
List organization app installations
List organization app installations
List org level codespaces secrets
List org level codespaces secrets
List organization events for the authenticated user
List organization events for the authenticated user
GITHUB_LIST_ORGANIZATION_EVENTS_FOR_THE_AUTHENTICATED_USERLists public events for the authenticated user’s organization dashboard in a specified GitHub organization, such as pushes, pull requests, issues, and forks. The user must be an organization member to see events. Results are paginated; a 404 response is reported as an empty event list.Input Parameters
Output
List organization members
List organization members
List organization memberships for authenticated user
List organization memberships for authenticated user
List organization projects
List organization projects
GITHUB_LIST_ORGANIZATION_PROJECTSLists projects (V2) for a specified GitHub organization, with optional search query and cursor-based pagination.Input Parameters
Output
List organization repositories
List organization repositories
GITHUB_LIST_ORGANIZATION_REPOSITORIESRetrieves a list of repositories for a specified GitHub organization, allowing filtering by type and sorting.Input Parameters
created, updated, pushed, or full_name.all, public, private (requires permissions), forks, sources (not forks), or member (repositories with explicit user access).asc (ascending) or desc (descending). Defaults to asc if sort is full_name, else desc.Output
Get all organization roles for an organization
Get all organization roles for an organization
List organizations
List organizations
List organization secrets
List organization secrets
List organizations for a user
List organizations for a user
List organizations for the authenticated user
List organizations for the authenticated user
List organizations for a user
List organizations for a user
GITHUB_LIST_ORGANIZATIONS_FOR_USERList a page of public organization memberships for a specified GitHub user, with pagination controls.Input Parameters
Output
List organization variables
List organization variables
List organization webhooks
List organization webhooks
List organization fine-grained permissions
List organization fine-grained permissions
GITHUB_LIST_ORG_FINE_GRAINED_PERMISSIONSLists all fine-grained permissions available in a GitHub organization for use in custom organization roles. These permissions define granular access controls that can be combined when creating custom roles. Note: This endpoint requires GitHub Enterprise Cloud with the custom organization roles feature enabled. The authenticated user must be an administrator or have the ‘read_organization_custom_org_role’ permission.Input Parameters
Output
List organization issues assigned to the authenticated user
List organization issues assigned to the authenticated user
GITHUB_LIST_ORG_ISSUES_FOR_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.Input Parameters
YYYY-MM-DDTHH:MM:SSZ.assigned, created, mentioned, subscribed, or all/repos for all accessible issues).bug,ui,@high. Issues returned must match all specified labels.Output
List package versions for an organization package
List package versions for an organization package
GITHUB_LIST_ORG_PACKAGE_VERSIONSLists a page of versions for a specified package owned by a GitHub organization, filtered by active or deleted state. Defaults to active versions.Input Parameters
maven; images in ghcr.io use container; docker type can find images from docker.pkg.github.com, including those migrated to ghcr.io.Output
List organization project view items
List organization project view items
GITHUB_LIST_ORG_PROJECT_VIEW_ITEMSLists a page of items in a specific view of a GitHub organization’s Projects V2 project, with their content, metadata, and field values. Returns pagination cursors when available.Input Parameters
Output
List organization repositories with Github Actions enabled
List organization repositories with Github Actions enabled
GITHUB_LIST_ORG_REPOS_WITH_GITHUB_ACTIONS_ENABLEDLists the selected repositories that are enabled for GitHub Actions in an organization. This endpoint only returns results when the organization’s ‘enabled_repositories’ permission policy is configured to ‘selected’. Requires admin:org scope and organization admin permissions.Input Parameters
Output
List org resource access tokens
List org resource access tokens
GITHUB_LIST_ORG_RESOURCE_ACCESS_TOKENSLists approved fine-grained personal access tokens with access to a GitHub organization’s resources, with optional filters; requires a GitHub App with read access to the organization’s personal access tokens. Non-list API responses are returned as an empty token list.Input Parameters
Output
List org resources with personal tokens
List org resources with personal tokens
GITHUB_LIST_ORG_RESOURCES_WITH_PERSONAL_TOKENSLists requests from organization members to access organization resources with fine-grained personal access tokens (pending, approved, or denied). Note: This endpoint requires GitHub App authentication with ‘organization_personal_access_token_requests:read’ permissions; it cannot be used with personal access tokens.Input Parameters
Output
List organization Dependabot secrets without values
List organization Dependabot secrets without values
GITHUB_LIST_ORG_SECRETS_WITHOUT_VALUESLists a page of Dependabot secret metadata for a specified organization, including names and creation and update timestamps, without secret values.Input Parameters
Output
List outside collaborators for an organization
List outside collaborators for an organization
GITHUB_LIST_OUTSIDE_COLLABORATORS_FOR_AN_ORGANIZATIONLists outside collaborators for a GitHub organization, with options to filter (e.g., by 2FA status) and paginate results.Input Parameters
Output
List owned package versions
List owned package versions
GITHUB_LIST_OWNED_PACKAGE_VERSIONSLists a page of versions for an existing package owned by the authenticated user, identified by its type and name. Results can be filtered by active or deleted state.Input Parameters
maven. Docker images pushed to GitHub’s Container registry (ghcr.io) have the type container. Use docker to find images from GitHub’s Docker registry (docker.pkg.github.com), even if migrated.Output
List packages for an organization
List packages for an organization
GITHUB_LIST_PACKAGES_FOR_AN_ORGANIZATIONLists GitHub Packages for an organization, noting specific interpretations for package_type and visibility parameters.Input Parameters
Output
List packages for a user
List packages for a user
GITHUB_LIST_PACKAGES_FOR_A_USERLists packages for a specified GitHub user, filterable by package type and visibility.Input Parameters
internal visibility is supported only for GitHub Packages registries allowing granular permissions; for others, internal is synonymous with private.maven. Images in ghcr.io (Container registry) are container. Use docker for images from docker.pkg.github.com, including those migrated to the Container registry.Output
List packages for the authenticated user's namespace
List packages for the authenticated user's namespace
GITHUB_LIST_PACKAGES_FOR_THE_AUTHENTICATED_USERLists packages of a specific type and visibility within the authenticated user’s namespace on GitHub.Input Parameters
Output
List package versions for a package owned by a user
List package versions for a package owned by a user
GITHUB_LIST_PACKAGE_VERSIONS_FOR_A_PACKAGE_OWNED_BY_A_USERLists a page of versions of a public package owned by a specified GitHub user, identified by package type, package name, and username.Input Parameters
Output
List pending team invitations
List pending team invitations
GITHUB_LIST_PENDING_TEAM_INVITATIONSLists a page of pending membership invitations for a specified team within an organization, including invitee, role, and inviter details; total_count is the number returned on that page. The authenticated user must be an organization member with read:org scope.Input Parameters
Output
List project cards (Classic - Deprecated)
List project cards (Classic - Deprecated)
GITHUB_LIST_PROJECT_CARDSLists project cards in a GitHub Projects (classic) column, with archive filtering and pagination. The classic Projects REST API was sunset on April 1, 2025; the tool returns an empty card list for HTTP 404 or 410, which can also mask an unavailable or missing column.Input Parameters
Output
List project collaborators (classic)
List project collaborators (classic)
GITHUB_LIST_PROJECT_COLLABORATORSLists collaborators for a GitHub Project (classic) by project ID. IMPORTANT: This action uses the Projects (classic) REST API which was sunset on April 1, 2025 for GitHub.com. The API may still be available on GitHub Enterprise Server versions before 3.17. For GitHub.com users: GitHub Projects (classic) has been replaced by the new Projects experience. The new Projects does not have a REST API for listing collaborators - use the GitHub web interface to manage project collaborators instead. You must be an organization owner or a project admin to list collaborators.Input Parameters
Output
List project columns
List project columns
GITHUB_LIST_PROJECT_COLUMNSLists a page of columns in a GitHub Projects (classic) project, such as its stages of work. A missing or unavailable project can produce an empty list. DEPRECATED: The Projects (classic) REST API has been sunset; use the newer GitHub Projects instead. Projects (classic) was removed from GitHub Enterprise Server 3.17.Input Parameters
Output
List project fields for user
List project fields for user
GITHUB_LIST_PROJECT_FIELDS_FOR_USERTool to list all fields in a GitHub Projects V2 project for a specific user. Use when you need to see available fields in a project.Input Parameters
Output
List project items for user
List project items for user
GITHUB_LIST_PROJECT_ITEMS_FOR_USERLists a page of items, including issues, pull requests and draft issues, in a user-owned GitHub project. Supports cursor pagination and filtering.Input Parameters
Output
List items for user project view
List items for user project view
GITHUB_LIST_PROJECT_VIEW_ITEMS_FOR_USERTool to list items for a user’s GitHub Projects (v2) view. Use when you need to retrieve items from a specific view of a user’s project. Supports pagination and field filtering.Input Parameters
Output
List public email addresses for the authenticated user
List public email addresses for the authenticated user
List public events
List public events
GITHUB_LIST_PUBLIC_EVENTSLists public GitHub events, which may be delayed by up to 5 minutes, with support for pagination.Input Parameters
Output
List public events for a network of repositories
List public events for a network of repositories
GITHUB_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.Input Parameters
.git extension. This name is not case-sensitive.Output
List public events for a user
List public events for a user
List public events received by a user
List public events received by a user
GITHUB_LIST_PUBLIC_EVENTS_RECEIVED_BY_A_USERLists public events for a specified GitHub user (e.g., activities in repositories they watch or are involved in); the target user’s profile must be public, and if blocked by the authenticated user, a 404 error is returned.Input Parameters
Output
List public gists
List public gists
List public keys for a user
List public keys for a user
GITHUB_LIST_PUBLIC_KEYS_FOR_A_USERLists the verified public SSH keys for a specified GitHub user.Input Parameters
Output
List public organization events
List public organization events
GITHUB_LIST_PUBLIC_ORGANIZATION_EVENTSLists public events for a specified GitHub organization, which must exist. This action retrieves the events that are publicly accessible for the organization specified. It returns a paginated list of events with details about each event.Input Parameters
Output
List public organization members
List public organization members
List public repositories
List public repositories
List pull requests
List pull requests
GITHUB_LIST_PULL_REQUESTSLists pull requests for a GitHub repository. REQUIRES ‘owner’ AND ‘repo’ parameters - both are MANDATORY and must be provided in every call. Does NOT support filtering by assignee or date range - use GITHUB_FIND_PULL_REQUESTS instead for searching PRs by assignee, author, or across multiple repositories.Input Parameters
.git extension). This parameter is mandatory and cannot be omitted. Example: ‘Spoon-Knife’ or ‘vscode’. To search PRs across multiple repos, use GITHUB_FIND_PULL_REQUESTS instead.Output
List pull requests associated with a commit
List pull requests associated with a commit
GITHUB_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.Input Parameters
Output
List pull requests files
List pull requests files
GITHUB_LIST_PULL_REQUESTS_FILESLists a page of files changed in a specified GitHub pull request, including additions, modifications, and removals.Input Parameters
.git extension. This field is not case sensitive.Output
List reactions for a commit comment
List reactions for a commit comment
List reactions for an issue
List reactions for an issue
List reactions for an issue comment
List reactions for an issue comment
GITHUB_LIST_REACTIONS_FOR_AN_ISSUE_COMMENTLists reactions for a specific issue comment in a GitHub repository, optionally filtering by content type.Input Parameters
.git extension. This name is not case sensitive.Output
List reactions for a pull request review comment
List reactions for a pull request review comment
List reactions for a release
List reactions for a release
GITHUB_LIST_REACTIONS_FOR_A_RELEASELists a page of reactions for a GitHub release, optionally filtered by reaction type.Input Parameters
Output
List reactions for a team discussion
List reactions for a team discussion
GITHUB_LIST_REACTIONS_FOR_A_TEAM_DISCUSSIONLists a page of reactions for an existing team discussion within an organization, optionally filtered by reaction type. OAuth app tokens and personal access tokens (classic) need the read:discussion scope.Input Parameters
Output
List reactions for a team discussion comment
List reactions for a team discussion comment
List release assets
List release assets
GITHUB_LIST_RELEASE_ASSETSLists assets (e.g., compiled binaries, source code archives) for a specific GitHub release, identified by release_id which must be valid for an existing release in the repository.Input Parameters
Output
List releases
List releases
GITHUB_LIST_RELEASESRetrieves a page of releases for a specified repository, including published releases and available draft and prerelease versions.Input Parameters
.git extension. This name is not case-sensitive.Output
List repo access by token
List repo access by token
GITHUB_LIST_REPO_ACCESS_BY_TOKENLists repositories in an organization that a fine-grained personal access token has requested access to. Only GitHub Apps can use this endpoint. Requires ‘Personal access token requests’ organization permissions (read).Input Parameters
Output
List repo codespaces for authenticated user
List repo codespaces for authenticated user
List repo dev container configs for user
List repo dev container configs for user
List authenticated user's repository invitations
List authenticated user's repository invitations
List repository notifications for the authenticated user
List repository notifications for the authenticated user
GITHUB_LIST_REPO_NOTIFICATIONS_FOR_AUTH_USERRetrieves notifications for the authenticated user from a specified repository, to which the user must have access.Input Parameters
true, shows notifications marked as read; otherwise, only unread notifications are returned..git extension. The name is not case sensitive.YYYY-MM-DDTHH:MM:SSZ).YYYY-MM-DDTHH:MM:SSZ).true, shows only notifications in which the authenticated user is directly participating or was mentioned.Output
List repo secrets without values
List repo secrets without values
List repositories
List repositories
GITHUB_LIST_REPOSITORIESLists repositories accessible to the authenticated user based on visibility, affiliation, and type filters. Returns repositories owned by the user, those they collaborate on, or those accessible through organization membership. Use this action when you need to retrieve a comprehensive list of repositories the authenticated user can access, with options to filter by visibility (public/private), affiliation (owner/collaborator/organization), or type. Supports pagination for large result sets.Input Parameters
Output
List repos accessible to app installation
List repos accessible to app installation
GITHUB_LIST_REPOSITORIES_ACCESSIBLE_TO_THE_APP_INSTALLATIONLists repositories a GitHub App installation can access. IMPORTANT: This endpoint requires a GitHub App installation access token (ghs_* prefix) for authentication. OAuth/user access tokens (gho_*) or personal access tokens are not supported and will result in a 403 Forbidden error. Returns ‘total_count’ and ‘repositories’ array with pagination support.Input Parameters
Output
List repositories for a user
List repositories for a user
GITHUB_LIST_REPOSITORIES_FOR_A_USERLists public repositories for a specified GitHub user, who must have an existing account.Input Parameters
created (default), updated, pushed, or full_name (repository name). When not specified, GitHub API defaults to created.all (owned or member), owner (directly owned), member (user is a public member), or public (public repositories only). When omitted, API returns all public repositories.asc (ascending) or desc (descending). When not specified, defaults to asc for full_name sort, and desc for all other sort options.Output
List repositories for the authenticated user
List repositories for the authenticated user
GITHUB_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.Input Parameters
asc when sort is ‘full_name’, and desc otherwise.Output
List repositories starred by a user
List repositories starred by a user
GITHUB_LIST_REPOSITORIES_STARRED_BY_A_USERLists repositories a valid and existing GitHub user has starred.Input Parameters
created sorts by the date the repository was starred. updated sorts by the date the repository was last pushed to.asc for ascending or desc for descending.Output
List repositories starred by the authenticated user
List repositories starred by the authenticated user
List repositories watched by a user
List repositories watched by a user
List repositories watched by the authenticated user
List repositories watched by the authenticated user
GITHUB_LIST_REPOSITORIES_WATCHED_BY_THE_AUTHENTICATED_USERLists repositories the authenticated user is watching (subscribed to for notifications). This action retrieves a list of repositories that the authenticated user is currently watching. It allows the user to manage their watched repositories effectively.Input Parameters
Output
List repos with ghactions cache usage
List repos with ghactions cache usage
GITHUB_LIST_REPOSITORIES_WITH_GITHUB_ACTIONS_CACHE_USAGERetrieves a paginated list of GitHub Actions cache usage statistics for repositories within an existing GitHub organization.Input Parameters
Output
List repository activities
List repository activities
GITHUB_LIST_REPOSITORY_ACTIVITIESLists activities for a GitHub repository, ensuring the repository exists and is accessible.Input Parameters
main or a full ref like refs/heads/main). If unspecified, activities from all branches are listed..git extension. This name is not case-sensitive.Link header in a previous API response. For more details, see GitHub’s REST API documentation on “Using pagination in the REST API” and “Using Link headers”.Link header in a previous API response. For more details, see GitHub’s REST API documentation on “Using pagination in the REST API” and “Using Link headers”.Output
Get all autolinks of a repository
Get all autolinks of a repository
List repository collaborators
List repository collaborators
GITHUB_LIST_REPOSITORY_COLLABORATORSLists collaborators for a specified repository, provided it exists and is accessible to the authenticated user.Input Parameters
.git extension. This value is not case sensitive.Output
List repository contributors
List repository contributors
GITHUB_LIST_REPOSITORY_CONTRIBUTORSLists contributors to a specified repository, sorted by number of contributions in descending order; the repository must exist and be accessible.Input Parameters
Output
List repository Dependabot alerts
List repository Dependabot alerts
GITHUB_LIST_REPOSITORY_DEPENDABOT_ALERTSList Dependabot vulnerability alerts for a repository with filters and cursor pagination.Input Parameters
.git extension. The name is not case sensitive.unknown, direct, transitive, and inconclusive.Output
List repository events
List repository events
List repository invitations
List repository invitations
GITHUB_LIST_REPOSITORY_INVITATIONSLists a page of pending collaboration invitations for a specified GitHub repository.Input Parameters
Output
List repository issues
List repository issues
GITHUB_LIST_REPOSITORY_ISSUESLists issues (including pull requests) from a GitHub repository. Requires BOTH ‘owner’ AND ‘repo’ parameters (e.g., owner=‘octocat’, repo=‘Hello-World’ for github.com/octocat/Hello-World).Input Parameters
YYYY-MM-DDTHH:MM:SSZ).number as a string, ’*’ for issues with any milestone, or ‘none’ for issues without a milestone.Output
List repository languages
List repository languages
GITHUB_LIST_REPOSITORY_LANGUAGESLists the programming languages used in a GitHub repository, returning a byte count for each language.Input Parameters
.git extension. This name is not case-sensitive.Output
List repository organization secrets
List repository organization secrets
List repository organization variables
List repository organization variables
GITHUB_LIST_REPOSITORY_ORGANIZATION_VARIABLESLists organization-level variables that are shared with a specific repository. The repository must belong to an organization (not a personal account).Input Parameters
Output
List repository projects
List repository projects
GITHUB_LIST_REPOSITORY_PROJECTSLists a page of a repository’s Projects (classic), filtered by open, closed, or all states. An empty result with a message can also indicate that the repository was not found or classic projects are not enabled. DEPRECATED: The classic Projects REST API has been sunset; use GitHub Projects V2 instead.Input Parameters
Output
Get all repository rulesets
Get all repository rulesets
GITHUB_LIST_REPOSITORY_RULESETSRetrieves a page of rulesets for a GitHub repository, including parent rulesets by default. Rulesets define conditions and actions for repository interactions such as branch protection.Input Parameters
True, also fetches rulesets from parent levels (e.g., organization) applicable to this repository.Output
List repository rule suites
List repository rule suites
GITHUB_LIST_REPOSITORY_RULE_SUITESLists rule suite evaluations for a repository, allowing filtering by ref (non-wildcard), time period, actor, and result.Input Parameters
Output
List repository secrets
List repository secrets
GITHUB_LIST_REPOSITORY_SECRETSLists a page of metadata for GitHub Actions secrets in a repository, including names and timestamps but not secret values.Input Parameters
.git extension. The name is not case-sensitive.Output
List repository secrets without decrypting
List repository secrets without decrypting
GITHUB_LIST_REPOSITORY_SECRETS_WITHOUT_DECRYPTINGLists a page of metadata for Dependabot secrets in a repository, including names and creation and update dates; secret values are not included.Input Parameters
.git extension. This field is not case sensitive.Output
List repository security advisories
List repository security advisories
GITHUB_LIST_REPOSITORY_SECURITY_ADVISORIESLists repository security advisories, optionally filtered by state and sorted or paginated.Input Parameters
Output
List repository teams
List repository teams
GITHUB_LIST_REPOSITORY_TEAMSLists a page of teams with explicit permission to access the specified repository; the repository must exist.Input Parameters
.git extension. This value is not case-sensitive.Output
Get all repository topics
Get all repository topics
List repository variables
List repository variables
GITHUB_LIST_REPOSITORY_VARIABLESLists plain text key-value variables for GitHub Actions workflows within a specific, accessible repository.Input Parameters
.git extension. The name is not case sensitive.Output
List repository webhooks
List repository webhooks
GITHUB_LIST_REPOSITORY_WEBHOOKSRetrieves a list of webhooks for a repository, which must exist and be accessible.Input Parameters
.git extension. This name is not case-sensitive.Output
List repository workflows
List repository workflows
GITHUB_LIST_REPOSITORY_WORKFLOWSLists a page of GitHub Actions workflows for a specified repository, which must exist and be accessible. The response includes the total workflow count.Input Parameters
.git extension. This field is not case-sensitive.Output
Get all requested reviewers for a pull request
Get all requested reviewers for a pull request
List review comments in a repository
List review comments in a repository
GITHUB_LIST_REVIEW_COMMENTS_IN_A_REPOSITORYLists a page of pull request review comments across a specified repository, with sorting and pagination options.Input Parameters
.git extension. This name is not case-sensitive.created (creation time), updated (last update time), or created_at (creation timestamp). Defaults to API’s standard sort order (typically by ID, ascending) if unspecified.YYYY-MM-DDTHH:MM:SSZ).Output
List review comments on a pull request
List review comments on a pull request
List reviews for a pull request
List reviews for a pull request
GITHUB_LIST_REVIEWS_FOR_A_PULL_REQUESTLists submitted reviews chronologically for a specific pull request within a GitHub repository.Input Parameters
.git extension. This name is not case sensitive.Output
List runner applications for an organization
List runner applications for an organization
GITHUB_LIST_RUNNER_APPLICATIONS_FOR_AN_ORGANIZATIONLists downloadable GitHub Actions runner application binaries for setting up self-hosted runners in a GitHub organization. Returns download URLs and checksums for various OS/architecture combinations (linux/win/osx on x64/arm/arm64). Requires admin:org scope or fine-grained ‘Self-hosted runners’ read permission.Input Parameters
Output
List runner applications for a repository
List runner applications for a repository
GITHUB_LIST_RUNNER_APPLICATIONS_FOR_A_REPOSITORYLists available self-hosted runner application binaries for a specific repository, including their OS, architecture, and download URL.Input Parameters
.git extension. This field is not case-sensitive.Output
List secret scanning alerts for a repository
List secret scanning alerts for a repository
GITHUB_LIST_SECRET_SCANNING_ALERTS_FOR_A_REPOSITORYList secret scanning alerts for a GitHub repository using first-party detections. Use this to retrieve detected secrets with filtering by state, type, resolution, and validity. Supports optional hiding of secret literals for security.Input Parameters
Output
List secrets for the authenticated user
List secrets for the authenticated user
List security advisories (GraphQL)
List security advisories (GraphQL)
GITHUB_LIST_SECURITY_ADVISORIES_GRAPHQLTool to list GitHub Security Advisories using the GraphQL API. Use when you need to query security vulnerabilities and malware advisories from the GitHub Advisory Database with advanced filtering and pagination options.Input Parameters
Output
List security vulnerabilities
List security vulnerabilities
GITHUB_LIST_SECURITY_VULNERABILITIESQuery software vulnerabilities documented by GitHub Security Advisories using GraphQL. Use this to find security issues in packages across ecosystems like npm, pip, maven, etc.Input Parameters
Output
List selected repositories for a Codespaces organization secret
List selected repositories for a Codespaces organization secret
GITHUB_LIST_SELECTED_REPOSITORIES_FOR_AN_ORGANIZATION_SECRETLists a page of repositories selected to access a Codespaces organization secret whose visibility is set to ‘selected’. Requires admin:org scope and admin access to the organization.Input Parameters
Output
List selected repositories for a user secret
List selected repositories for a user secret
GITHUB_LIST_SELECTED_REPOSITORIES_FOR_A_USER_SECRETLists repositories that have access to the specified user Codespaces secret. This endpoint retrieves all repositories that the authenticated user has granted access to for a specific user-level Codespaces secret. The secret must already exist for this endpoint to work. Use ‘list_secrets_for_the_authenticated_user’ to discover available secrets first. Note: The authenticated user must have Codespaces access enabled. OAuth tokens and personal access tokens require the ‘codespace’ or ‘codespace:secrets’ scope.Input Parameters
Output
List selected repos for secret access
List selected repos for secret access
GITHUB_LIST_SELECTED_REPOSITORIES_FOR_SECRET_ACCESSLists repositories within a specified organization that have been granted access to a particular Dependabot secret. Note: This endpoint only returns results when the secret’s visibility is set to ‘selected’. Secrets with visibility ‘all’ or ‘private’ do not have specific repository selections. Requires ‘admin:org’ scope and the user must have admin access to the organization.Input Parameters
Output
List selected repositories for an organization variable
List selected repositories for an organization variable
GITHUB_LIST_SELECTED_REPOS_ORG_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. Note: This endpoint only works for variables with visibility set to ‘selected’ - attempting to use it on variables with ‘all’ or ‘private’ visibility will result in a 409 Conflict error.Input Parameters
Output
List self hosted runners for an organization
List self hosted runners for an organization
List self hosted runners for a repository
List self hosted runners for a repository
GITHUB_LIST_SELF_HOSTED_RUNNERS_FOR_A_REPOSITORYLists self-hosted runners configured for a repository, with optional runner-name filtering and pagination.Input Parameters
.git extension. The name is not case sensitive.Output
List Sponsorable Users and Organizations
List Sponsorable Users and Organizations
GITHUB_LIST_SPONSORABLESTool to list users and organizations who can be sponsored via GitHub Sponsors. Use when you need to discover sponsorable entities with optional filtering by dependency ecosystem.Input Parameters
Output
List SSH signing keys for user
List SSH signing keys for user
GITHUB_LIST_SSH_SIGNING_KEYS_FOR_A_USERLists the public SSH signing keys for a specified GitHub user.Input Parameters
Output
List stargazers
List stargazers
List starred gists
List starred gists
List starred repositories for user
List starred repositories for user
GITHUB_LIST_STARRED_REPOSITORIES_FOR_USERLists a page of public repositories starred by a specified GitHub user, sorted by when they were starred or last updated. Supports pagination and sort direction.Input Parameters
Output
Get all status check contexts
Get all status check contexts
GITHUB_LIST_STATUS_CHECK_CONTEXTSFetches required status check contexts for a branch. Returns an empty list for 404 responses other than an explicit branch-not-found message, so an empty result does not necessarily establish that checks are absent.Input Parameters
.git extension. This name is not case-sensitive.*) are not permitted. For operations involving branches with wildcard patterns, the GitHub GraphQL API should be utilized.Output
List sub-issues for an issue
List sub-issues for an issue
GITHUB_LIST_SUB_ISSUESTool to list sub-issues for a specific GitHub issue. Use when you need to retrieve all sub-issues associated with a parent issue, supporting pagination for large hierarchies.Input Parameters
.git extension. The name is not case sensitive.Output
List marketplace subscriptions for authenticated user
List marketplace subscriptions for authenticated user
GITHUB_LIST_SUBSCRIPTIONS_FOR_THE_AUTHENTICATED_USERTool to list GitHub Marketplace subscriptions for the authenticated user. Use when you need to retrieve active marketplace app subscriptions including billing details, plan information, and trial status. Returns subscription information with account, plan, billing cycle, and pricing details.Input Parameters
Output
List stubbed subscriptions for the authenticated user
List stubbed subscriptions for the authenticated user
List tag protection states for a repository
List tag protection states for a repository
GITHUB_LIST_TAG_PROTECTION_STATES_FOR_A_REPOSITORYLists a repository’s legacy tag protection rules, including the patterns used to identify protected tags. DEPRECATED: GitHub sunset the tag protection API on GitHub.com and says it returns null data; use GITHUB_GET_ALL_REPOSITORY_RULESETS to view tag protection through repository rulesets instead.Input Parameters
.git extension. This name is not case sensitive.Output
List team members
List team members
List team projects
List team projects
List team repositories
List team repositories
GITHUB_LIST_TEAM_REPOSITORIESLists repositories accessible to a specific team within a GitHub organization. Returns a list of repositories that the specified team has access to, including the team’s permission level (admin, maintain, push, triage, pull) for each repository. Requires read:org scope and membership in the organization to access team data.Input Parameters
Output
List teams
List teams
List teams for the authenticated user
List teams for the authenticated user
GITHUB_LIST_TEAMS_FOR_THE_AUTHENTICATED_USERLists all teams across all organizations to which the authenticated user belongs, supporting pagination.Input Parameters
Output
List teams assigned to an organization role
List teams assigned to an organization role
GITHUB_LIST_TEAMS_THAT_ARE_ASSIGNED_TO_AN_ORGANIZATION_ROLELists a page of teams assigned to a specific role in a GitHub organization, helping administrators audit role assignments. Requires organization administrator privileges; page size can be set from 1 to 100.Input Parameters
Output
List the people a user follows
List the people a user follows
List people the authenticated user follows
List people the authenticated user follows
List timeline events for an issue
List timeline events for an issue
List token access repositories
List token access repositories
GITHUB_LIST_TOKEN_ACCESS_REPOSITORIESLists a page of repositories in an organization accessible to a specified fine-grained personal access token, for auditing its repository access. The caller must be an organization owner or have the Personal access tokens organization permission; the endpoint is for GitHub Apps.Input Parameters
Output
List user projects
List user projects
List users
List users
GITHUB_LIST_USERSLists a page of GitHub users, including individuals and organizations, in chronological order of sign-up. Supports pagination by starting user ID and results per page.Input Parameters
Output
List users blocked by an organization
List users blocked by an organization
GITHUB_LIST_USERS_BLOCKED_BY_AN_ORGANIZATIONLists users blocked by a specified GitHub organization.Input Parameters
Output
List users blocked by the authenticated user
List users blocked by the authenticated user
List users assigned org role
List users assigned org role
List watchers
List watchers
GITHUB_LIST_WATCHERSRetrieves a list of users watching a specific repository; the repository must be accessible to the authenticated user.Input Parameters
.git extension. This field is not case-sensitive.Output
List workflow run artifacts
List workflow run artifacts
List workflow runs for a repository
List workflow runs for a repository
GITHUB_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.Input Parameters
status or conclusion (e.g., success, in_progress). Note: Only GitHub Actions can set waiting, pending, or requested.>, <, >=, <=, and .. for ranges.head_sha (commit SHA at the head of the branch).true to exclude workflow runs triggered by pull request events. Omit or leave as null to include all runs.Output
List workflow runs for a workflow
List workflow runs for a workflow
GITHUB_LIST_WORKFLOW_RUNS_FOR_A_WORKFLOWLists runs for a specified, existing workflow (identified by ID or filename like main.yml) in a GitHub repository, with filtering options.Input Parameters
push, pull_request). For more event types, see GitHub’s documentation on “Events that trigger workflows”.success, in_progress). Note: waiting, pending, or requested statuses are set exclusively by GitHub Actions.main.yml or ci.yaml).Output
Lock an issue
Lock an issue
GITHUB_LOCK_AN_ISSUELocks an existing GitHub issue’s conversation, preventing further comments; an optional reason can be specified.Input Parameters
.git extension. This name is not case-sensitive.Output
Lookup Enterprise Administrator Invitation
Lookup Enterprise Administrator Invitation
GITHUB_LOOKUP_ENTERPRISE_ADMINISTRATOR_INVITATIONLook up a pending enterprise administrator invitation by invitee login, enterprise slug, and role. An empty result can indicate either no invitation was returned or a GraphQL resolution or not-found error.Input Parameters
Output
Lookup GitHub Resource
Lookup GitHub Resource
Lookup nodes by IDs
Lookup nodes by IDs
Lookup Organization (GraphQL)
Lookup Organization (GraphQL)
Look Up Topic by Name
Look Up Topic by Name
GITHUB_LOOKUP_TOPIC_BY_NAMETool to look up a GitHub topic by name using GraphQL. Use when you need to find information about a specific GitHub topic including its popularity (stargazer count) and related topics.Input Parameters
Output
Manage access control for organization codespaces
Manage access control for organization codespaces
GITHUB_MANAGE_ACCESS_CONTROL_FOR_ORGANIZATION_CODESPACESSets the Codespaces access control policy for a GitHub organization, determining which members can use them. This endpoint requires admin permissions on the organization. The API returns HTTP 204 No Content on success.Input Parameters
disabled: Codespaces are disabled for all users in the organization. selected_members: Only users specified in selected_usernames can access Codespaces. all_members: All members of the organization can access Codespaces. all_members_and_outside_collaborators: All members and outside collaborators can access Codespaces.visibility is set to selected_members. Providing a list here will replace any existing list of selected usernames. The specified users must be members or outside collaborators of the organization.Output
Manage custom properties for org repos
Manage custom properties for org repos
GITHUB_MANAGE_CUSTOM_PROPERTIES_FOR_ORG_REPOSCreates or updates values for an organization’s predefined custom properties across multiple repositories (up to 30).Input Parameters
property_name (predefined for the organization) and value. Example: ’[{“property_name”: “project-status”, “value”: “active”}]’Output
Manage issue blocking dependency
Manage issue blocking dependency
List selected repositories for a GitHub Actions organization secret
List selected repositories for a GitHub Actions organization secret
GITHUB_MANAGE_SECRETS_IN_SELECTED_REPOSITORIESLists a page of repositories explicitly selected to access a GitHub Actions organization secret. The secret’s visibility must be set to ‘selected’; organization admin access and appropriate authorization are required.Input Parameters
Output
Mark a thread as done
Mark a thread as done
GITHUB_MARK_A_THREAD_AS_DONEMarks the GitHub notification thread (identified by thread_id) as done or read for the authenticated user, effectively archiving it.Input Parameters
id field in notification list operations (e.g., GET /notifications).Output
Mark a thread as read
Mark a thread as read
GITHUB_MARK_A_THREAD_AS_READMarks an existing GitHub notification thread, identified by its thread_id, as read.Input Parameters
id field, for example, via the ‘List notifications for the authenticated user’ endpoint.Output
Mark notifications as read
Mark notifications as read
GITHUB_MARK_NOTIFICATIONS_AS_READMarks notifications as read or unread, optionally for those updated at or before a last_read_at timestamp.Input Parameters
true) or unread (false). Defaults to true (mark as read) if not provided.Output
Mark pull request ready for review
Mark pull request ready for review
GITHUB_MARK_PULL_REQUEST_READY_FOR_REVIEWMarks a draft pull request as ready for review using GitHub GraphQL API, transitioning it from draft to reviewable state. Use this action when a draft pull request has reached a stage where it is ready for team review and can potentially be merged. This action cannot be used on pull requests that are already marked as ready for review.Input Parameters
Output
Mark repository notifications as read
Mark repository notifications as read
GITHUB_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.Input Parameters
YYYY-MM-DDTHH:MM:SSZ). If provided, notifications updated after this time will NOT be marked as read. If omitted, all notifications in the repository are marked as read. Defaults to the current time.Output
Merge a branch
Merge a branch
Merge a pull request
Merge a pull request
GITHUB_MERGE_A_PULL_REQUESTMerges an open and mergeable pull request in a repository. A 405 error can occur for multiple reasons: (1) The PR is still in draft mode - convert it to ready-for-review first using GITHUB_UPDATE_A_PULL_REQUEST. (2) Branch protection rules are not satisfied - check for required approving reviews, status checks, or other repository rules that must be met before merging. (3) The base branch has been modified since the PR was last synced - update the PR branch first using GITHUB_UPDATE_A_PULL_REQUEST_BRANCH.Input Parameters
Output
Move a project card (Classic - Deprecated)
Move a project card (Classic - Deprecated)
GITHUB_MOVE_A_PROJECT_CARDMoves a project card to a specified position within a column (GitHub Classic Projects). DEPRECATION NOTICE: GitHub Projects (classic) and its REST API were sunset on April 1, 2025. This action will return 404 for most requests on GitHub.com. It may still work on GitHub Enterprise Server instances where classic projects remain enabled. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/ On success, the API returns HTTP 201 with an empty body, indicating the card was moved.Input Parameters
Output
Move a project column (Classic - Deprecated)
Move a project column (Classic - Deprecated)
GITHUB_MOVE_A_PROJECT_COLUMNMoves a column within a GitHub Classic Project to the first or last position, or after a specified column. DEPRECATED: The Classic Projects REST API has been sunset and this action no longer works on GitHub.com. Use GitHub Projects V2 with the GraphQL API for new projects.Input Parameters
Output
Ping an organization webhook
Ping an organization webhook
GITHUB_PING_AN_ORGANIZATION_WEBHOOKSends a ping event to a specified existing organization webhook to test its configuration. A successful request queues the event; it does not confirm delivery.Input Parameters
X-GitHub-Hook-ID header of a webhook delivery.Output
Ping a repository webhook
Ping a repository webhook
GITHUB_PING_A_REPOSITORY_WEBHOOKPings an existing webhook on a repository to test its configuration and reachability by GitHub.Input Parameters
.git extension. The name is not case sensitive.X-GitHub-Hook-ID header of a webhook delivery.Output
Privately report a security vulnerability
Privately report a security vulnerability
GITHUB_PRIVATELY_REPORT_A_SECURITY_VULNERABILITYPrivately reports a security vulnerability to a repository’s maintainers. IMPORTANT: You cannot report vulnerabilities to repositories you own - this API is for third-party security researchers to report to other repositories. The target repository must have private vulnerability reporting enabled. Specify EITHER severity OR cvss_vector_string, but not both.Input Parameters
.git extension. This name is not case-sensitive.cvss_vector_string.Output
Publish Sponsors Tier (GraphQL)
Publish Sponsors Tier (GraphQL)
GITHUB_PUBLISH_SPONSORS_TIER_GRAPH_QLTool to publish a draft GitHub Sponsors tier using GraphQL. Use when you need to make a draft sponsors tier visible to potential sponsors. The tier must already exist in draft status.Input Parameters
Output
Redeliver a delivery for an organization webhook
Redeliver a delivery for an organization webhook
GITHUB_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.Input Parameters
X-GitHub-Hook-ID header of a webhook delivery or by listing webhooks for an organization.X-GitHub-Delivery header of the original delivery attempt or by listing deliveries for a webhook.Output
Redeliver a delivery for a repository webhook
Redeliver a delivery for a repository webhook
GITHUB_REDELIVER_A_DELIVERY_FOR_A_REPOSITORY_WEBHOOKRedelivers a specific, previously made webhook delivery (delivery_id) for a repository’s webhook (hook_id).Input Parameters
X-GitHub-Hook-ID header or by listing repository webhooks).Output
Remove a custom property for an organization
Remove a custom property for an organization
Remove a label from an issue
Remove a label from an issue
GITHUB_REMOVE_A_LABEL_FROM_AN_ISSUERemoves a label currently applied to a specific issue in a repository.Input Parameters
.git extension. The name is not case sensitive.Output
Remove all labels from an issue
Remove all labels from an issue
GITHUB_REMOVE_ALL_LABELS_FROM_AN_ISSUERemoves all labels from a specified issue in a GitHub repository; this operation is idempotent.Input Parameters
Output
Remove all organization roles for a team
Remove all organization roles for a team
GITHUB_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.Input Parameters
Output
Remove all organization roles for a user
Remove all organization roles for a user
GITHUB_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.Input Parameters
Output
Remove an organization member
Remove an organization member
GITHUB_REMOVE_AN_ORGANIZATION_MEMBERRemoves a member from a GitHub organization. This action permanently removes a user’s membership from the specified organization, revoking their access to all organization resources, repositories, and teams. Requirements: - The authenticated user must be an organization owner - The target user must currently be a member of the organization Note: This action cannot be used to remove the last owner of an organization.Input Parameters
Output
Remove an organization role from a team
Remove an organization role from a team
Remove an organization role from a user
Remove an organization role from a user
GITHUB_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.Input Parameters
Output
Remove app access restrictions
Remove app access restrictions
GITHUB_REMOVE_APP_ACCESS_RESTRICTIONSRemoves all GitHub App access restrictions from a protected branch without altering user or team restrictions. A 404 is returned as an empty app list with an explanatory message rather than an exception.Input Parameters
.git extension. This field is not case-sensitive.Output
Remove a project from a team
Remove a project from a team
Remove a repository collaborator
Remove a repository collaborator
Remove a repository from an app installation
Remove a repository from an app installation
GITHUB_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.Input Parameters
Output
Remove a repository from a team
Remove a repository from a team
GITHUB_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.Input Parameters
Output
Remove a selected repository from a user secret
Remove a selected repository from a user secret
GITHUB_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.Input Parameters
Output
Remove assignees from an issue
Remove assignees from an issue
GITHUB_REMOVE_ASSIGNEES_FROM_AN_ISSUERemoves specified assignees from a GitHub issue; requires push access, and invalid removal attempts are silently ignored.Input Parameters
.git extension. This name is not case-sensitive.Output
Remove custom label from repo runner
Remove custom label from repo runner
GITHUB_REMOVE_CUSTOM_LABEL_FROM_REPO_RUNNERRemoves a custom label from a repository’s self-hosted runner; this operation is idempotent.Input Parameters
Output
Remove custom label from self hosted runner
Remove custom label from self hosted runner
Remove custom labels from self hosted repo runner
Remove custom labels from self hosted repo runner
GITHUB_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.Input Parameters
.git extension. This name is not case-sensitive.Output
Remove interaction restrictions for an organization
Remove interaction restrictions for an organization
Remove interaction restrictions for a repository
Remove interaction restrictions for a repository
Remove org dev env secret by name
Remove org dev env secret by name
Remove org secret by name
Remove org secret by name
Remove outside collaborator from an organization
Remove outside collaborator from an organization
Remove public org membership
Remove public org membership
GITHUB_REMOVE_PUBLIC_ORG_MEMBERSHIPRemoves the authenticated user’s public organization membership, making it private. The user remains a member of the organization but their membership is no longer publicly visible. This operation is idempotent - calling it when the membership is already private will succeed.Input Parameters
Output
Remove user public repo interaction restrictions
Remove user public repo interaction restrictions
Remove repository from organization dev environment secret
Remove repository from organization dev environment secret
Remove selected repo from org secret
Remove selected repo from org secret
Remove requested reviewers from a pull request
Remove requested reviewers from a pull request
GITHUB_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.Input Parameters
logins for removal. At least one of reviewers or team_reviewers must be specified.slugs (URL-friendly names) for removal. At least one of reviewers or team_reviewers must be specified.Output
Remove review request
Remove review request
GITHUB_REMOVE_REVIEW_REQUESTRemoves requested reviewers from a pull request. Use this action when you need to cancel a review request that was previously sent to users or teams. Only users with push access to the repository can remove review requests.Input Parameters
Output
Remove selected repository from an organization secret
Remove selected repository from an organization secret
Remove selected repository from an organization variable
Remove selected repository from an organization variable
GITHUB_REMOVE_SELECTED_REPO_FROM_ORG_VARIABLERemoves a repository’s access to an organization variable that has ‘selected’ visibility. This endpoint removes a specific repository from an organization variable’s access list. The variable must have its visibility set to ‘selected’ for this operation to work. Returns a 409 Conflict error if the variable visibility is not ‘selected’.Input Parameters
Output
Remove status check contexts
Remove status check contexts
GITHUB_REMOVE_STATUS_CHECK_CONTEXTSRemoves specified status check contexts from a protected branch’s required status checks. This action removes the specified status check contexts from the existing list of required status checks for a protected branch. The branch must already have branch protection enabled with status checks configured. Note: The ‘contexts’ parameter is deprecated by GitHub in favor of ‘checks’ array. For new implementations, consider using update_status_check_protection with the ‘checks’ parameter instead.Input Parameters
.git extension. This name is not case sensitive.Output
Remove status check protection
Remove status check protection
Remove team access restrictions
Remove team access restrictions
GITHUB_REMOVE_TEAM_ACCESS_RESTRICTIONSRemoves specified teams from push access to a protected branch. This action removes teams from the list of teams with push access to a protected branch. Removing a team will also remove push access for any child teams. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must currently have push access to the branchInput Parameters
.git extension. This value is not case-sensitive.Output
Remove team membership
Remove team membership
GITHUB_REMOVE_TEAM_MEMBERSHIPTool to remove team membership for a user in an organization. Use when you need to revoke a user’s membership from a specific team. This action is irreversible — the user must be explicitly re-added if you want to restore their team membership. Note that if team synchronization is set up, this operation may fail with a 403 Forbidden error.Input Parameters
Output
Remove team membership for a user
Remove team membership for a user
GITHUB_REMOVE_TEAM_MEMBERSHIP_FOR_A_USERRemoves a user from a specific team within an organization. This action requires admin:org scope permissions. It will fail if: - Team synchronization with an Identity Provider (IdP) is enabled (403 Forbidden) - The organization, team, or user membership doesn’t exist (404 Not Found) - You don’t have sufficient permissions to manage team memberships (403 Forbidden) Note: If the removed user was the last member and the team is not nested, the team may be deleted automatically.Input Parameters
Output
Remove user access restrictions
Remove user access restrictions
GITHUB_REMOVE_USER_ACCESS_RESTRICTIONSRemoves specified users from the list of people allowed to push to a protected branch. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must have protection rules with push restrictions enabled - Users being removed must currently have push access to the branch - The combined total of users, apps, and teams is limited to 100 itemsInput Parameters
Output
Remove user as a collaborator (classic project)
Remove user as a collaborator (classic project)
GITHUB_REMOVE_USER_AS_A_COLLABORATORRemoves a user as a collaborator from an organization project (classic); a success result can also indicate that the user was already absent. The Projects (classic) REST API is sunset on GitHub.com and may still work on GitHub Enterprise Server versions before 3.17.Input Parameters
Output
Remove users from codespaces access for an organization
Remove users from codespaces access for an organization
GITHUB_REMOVE_USERS_CODESPACES_ACCESS_ORGRemoves selected users from GitHub Codespaces billing access for an existing organization.Input Parameters
Output
Rename a branch
Rename a branch
GITHUB_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.Input Parameters
.git extension. The name is not case sensitive.Output
Render a markdown document
Render a markdown document
Render Markdown (Raw Mode)
Render Markdown (Raw Mode)
GITHUB_RENDER_MARKDOWN_RAWTool to render raw Markdown text to HTML using GitHub’s markdown API. Use when you need to convert plain Markdown content to HTML without GitHub-specific features like issue references or @mentions.Input Parameters
Output
Reopen an issue
Reopen an issue
GITHUB_REOPEN_ISSUEReopens a closed GitHub issue by changing its state to ‘open’ with state_reason ‘reopened’. Use this action when you need to reopen a previously closed issue that requires further attention or work. Only users with push access to the repository can reopen issues.Input Parameters
Output
Reopen Pull Request
Reopen Pull Request
GITHUB_REOPEN_PULL_REQUESTReopens a previously closed pull request by setting its state to ‘open’. This restores the pull request to an active state where it can be reviewed, commented on, and merged. Use this action when you need to reactivate a closed pull request that was closed prematurely or needs to be reconsidered for merging.Input Parameters
Output
Replace all repository topics
Replace all repository topics
GITHUB_REPLACE_ALL_REPOSITORY_TOPICSReplaces all topics of a repository.Input Parameters
[]). Note: Topic names cannot contain uppercase letters and are limited to 25 characters.Output
Replace org secret visibility to selected
Replace org secret visibility to selected
GITHUB_REPLACE_ORG_SECRET_VISIBILITY_TO_SELECTEDReplaces the list of repositories that can access a Dependabot organization secret when the secret’s visibility is already set to ‘selected’.Input Parameters
Output
Replace repository access for an org Codespaces secret
Replace repository access for an org Codespaces secret
GITHUB_REPLACE_REPO_ACCESS_ON_ORG_DEV_ENV_SECRET_SETReplaces the list of repositories that can access an organization-level Codespaces secret. This operation completely replaces the existing list of repositories with the provided list. The secret must already have its visibility set to ‘selected’ for this operation to succeed. Use this when you want to set an exact list of repositories that should have access. Prerequisites: - The organization must exist and you must have admin:org scope - The Codespaces secret must already exist in the organization - The secret’s visibility must be set to ‘selected’ (not ‘all’ or ‘private’) Returns HTTP 204 No Content on success, 404 if secret/org not found, 409 if visibility is not ‘selected’.Input Parameters
Output
Request a github pages build
Request a github pages build
GITHUB_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.Input Parameters
.git extension. This name is not case-sensitive.Output
Request reviewers for a pull request
Request reviewers for a pull request
GITHUB_REQUEST_REVIEWERSRequests reviewers for a specific pull request identified by owner, repository, and pull request number. Use this action when you need to add individual users or teams as reviewers to an existing pull request. At least one of reviewers (individual users) or team_reviewers (teams) must be provided.Input Parameters
reviewers or team_reviewers must be provided.reviewers or team_reviewers must be provided.Output
Add reviewers to a specific pull request
Add reviewers to a specific pull request
GITHUB_REQUEST_REVIEWERS_FOR_A_PULL_REQUESTAdds reviewers to a specific pull request identified by owner, repo, and pull_number. This is NOT a search action - it operates on an already-known PR number. Requires owner, repo, pull_number, and at least one of reviewers or team_reviewers.Input Parameters
login strings (usernames) to request reviews from. At least one of reviewers or team_reviewers must be provided.slug strings (e.g., ‘justice-league’) to request reviews from. Slugs are typically lowercase and use hyphens for spaces. At least one of reviewers or team_reviewers must be provided.Output
Rerequest a check run
Rerequest a check run
GITHUB_REREQUEST_A_CHECK_RUNTriggers a re-run of a specific check run in a GitHub repository, resetting its status to ‘queued’, clearing its conclusion, and triggering the check_run webhook with rerequested action. IMPORTANT: This endpoint requires GitHub App authentication with ‘checks:write’ permission. The check run can ONLY be re-requested by the same GitHub App that originally created it. OAuth tokens and personal access tokens (PAT) cannot use this endpoint.Input Parameters
.git extension. This field is case-insensitive.Output
Rerequest a check suite
Rerequest a check suite
GITHUB_REREQUEST_A_CHECK_SUITETriggers a new run of an existing check suite within a repository, resetting its status to ‘queued’, clearing its conclusion, and triggering the check_suite webhook with rerequested action. IMPORTANT: This endpoint requires GitHub App authentication with ‘checks:write’ permission. OAuth tokens and classic personal access tokens (PAT) cannot use this endpoint. Only GitHub App user access tokens, GitHub App installation access tokens, or fine-grained personal access tokens with checks:write permission are supported.Input Parameters
.git extension. This field is case-insensitive.Output
Re-run a job from a workflow run
Re-run a job from a workflow run
GITHUB_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.Input Parameters
.git extension. This name is not case sensitive.true, enables additional debug logging for the re-run of the job. Defaults to false if not provided.Output
Rerun a workflow
Rerun a workflow
Rerun failed jobs from a workflow run
Rerun failed jobs from a workflow run
GITHUB_RE_RUN_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.Input Parameters
true to enable extensive debug logging for the re-run, providing additional logs to aid in diagnosing issues.Output
Reset a token
Reset a token
GITHUB_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 rotation when a token may be compromised or for regular security maintenance. Note: This endpoint requires the OAuth App owner’s credentials (client_id/client_secret for Basic Auth).Input Parameters
Output
Restore a package for an organization
Restore a package for an organization
GITHUB_RESTORE_A_PACKAGE_FOR_AN_ORGANIZATIONRestores a package in an organization, provided it was deleted within the last 30 days.Input Parameters
maven. Docker images in ghcr.io use container; docker finds images from docker.pkg.github.com, even if migrated.Output
Restore a package for a user
Restore a package for a user
GITHUB_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).Input Parameters
maven for Gradle packages. docker can be used for images migrated from docker.pkg.github.com to the Container registry (ghcr.io), while container is for images originally pushed to ghcr.io.Output
Restore a package for the authenticated user
Restore a package for the authenticated user
GITHUB_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.Input Parameters
npm for Node.js packages, maven for Java packages. Special cases: packages in GitHub’s Gradle registry use the type maven. Docker images pushed to GitHub’s Container registry (ghcr.io) use the type container. The docker type can be used to find images originally pushed to GitHub’s Docker registry (docker.pkg.github.com), even if they have been migrated to the Container registry.Output
Restore a package version for the authenticated user
Restore a package version for the authenticated user
GITHUB_RESTORE_A_PACKAGE_VERSION_FOR_THE_AUTHENTICATED_USERRestores a package version that was deleted by the authenticated user within the last 30 days.Input Parameters
maven for GitHub’s Gradle registry. Use container for images in GitHub’s Container registry (ghcr.io). docker can be used for images previously in GitHub’s Docker registry (docker.pkg.github.com), even if migrated.Output
Restore package version for an organization
Restore package version for an organization
GITHUB_RESTORE_PACKAGE_VERSION_FOR_AN_ORGANIZATIONRestores a package version for an organization, provided it was deleted within the last 30 days.Input Parameters
maven type. Docker images in GitHub’s Container registry (ghcr.io) use the container type. The docker type can be used for images previously in GitHub’s Docker registry (docker.pkg.github.com), even if migrated to the Container registry.Output
Restore package version for a user
Restore package version for a user
GITHUB_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.Input Parameters
maven. Docker images pushed to GitHub’s Container registry (ghcr.io) have the type container. Use docker for images from GitHub’s Docker registry (docker.pkg.github.com), even if migrated to the Container registry.Output
Retire Sponsors Tier
Retire Sponsors Tier
GITHUB_RETIRE_SPONSORS_TIERTool to retire a published payment tier from your GitHub Sponsors profile using GraphQL. Use when you need to prevent a tier from being used for new sponsorships. Existing sponsors at this tier remain unaffected.Input Parameters
Output
Review access with personal token
Review access with personal token
GITHUB_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.Input Parameters
Output
Review Custom Deployment Rules For Workflow Run
Review Custom Deployment Rules For Workflow Run
GITHUB_REVIEW_DEPLOYMENT_PROTECTION_RULESApproves or rejects pending custom deployment protection rules for a workflow run. This endpoint allows GitHub Apps to review their own pending custom deployment protection rules for a specific workflow run. The review can either approve (allowing the deployment to proceed) or reject (blocking the deployment). Important notes: - GitHub Apps can only review their own custom deployment protection rules - This endpoint requires GitHub App installation access tokens with Deployments permission (write) - Custom deployment protection rules are available in public repos for all plans; for private/internal repos, GitHub Enterprise is required - Returns 204 No Content on successInput Parameters
Output
Review pending deployments for a workflow run
Review pending deployments for a workflow run
GITHUB_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.Input Parameters
.git extension. The name is not case sensitive.Output
Review PAT Requests in Bulk
Review PAT Requests in Bulk
GITHUB_REVIEW_RESOURCE_REQUESTS_WITH_FINE_GRAINED_TOKENSSubmits a bulk approval or denial of fine-grained personal access token requests for a GitHub organization. The returned success message indicates acceptance for processing, not confirmation that every request has been processed.Input Parameters
Output
Revoke an installation access token
Revoke an installation access token
GITHUB_REVOKE_AN_INSTALLATION_ACCESS_TOKENRevokes the GitHub App’s current installation access token, immediately invalidating it for API authentication. IMPORTANT: This endpoint requires a GitHub App installation access token (ghs_* prefix) for authentication. OAuth tokens (gho_*) or personal access tokens are not supported and will result in a 403 Forbidden error. After successful revocation, the token becomes permanently invalid and cannot be used for any subsequent API calls. To continue API operations, a new installation access token must be generated.Output
Run GraphQL Query
Run GraphQL Query
GITHUB_RUN_GRAPH_QL_QUERYTool to run an arbitrary GitHub GraphQL v4 query or mutation. Use when fetching multiple datasets in one batch. Cost-based rate limit: ~5,000 points/hour; keep field selections narrow, avoid deep nesting, and include rateLimit in responses to monitor quota. Responses are nested under data.data (e.g., data.data.repository.vulnerabilityAlerts); always inspect the errors array even on HTTP 200, as partial failures embed there. Paginate by looping on pageInfo.hasNextPage and advancing with pageInfo.endCursor. Search results cap at ~1,000 items per query; split by label, date range, or repository for full coverage. Use ProjectV2 nodes, not Classic Projects (deprecated). Parallel mutations (e.g., addProjectV2ItemById) can trigger transient conflicts; use sequential execution.Input Parameters
Output
Run GraphQL Relay Query
Run GraphQL Relay Query
GITHUB_RUN_GRAPH_QL_RELAY_QUERYRuns a supplied GitHub GraphQL query or mutation, including queries that access root fields through the relay context. The response may include GraphQL errors alongside data.Input Parameters
Output
Search code
Search code
GITHUB_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.Input Parameters
language:python, user:octocat, repo:owner/repo). For full syntax and qualifiers, see GitHub docs: Constructing a search query and code search qualifiers.sort is specified. Docs: ranking search results.Output
Search code (all pages)
Search code (all pages)
GITHUB_SEARCH_CODE_ALL_PAGESSearches GitHub code across multiple pages, optionally capped by a result limit; results may be partial, including because of GitHub’s approximately 1,000-result cap and default-branch indexing. Queries combining parentheses with AND, OR, or NOT are rejected by the tool.Input Parameters
language:, repo:, path:, extension:, user:, org:, in:file. Multiple terms use implicit AND: hello world finds both. Quote exact phrases: "exact phrase". For complex boolean logic, use multiple separate API calls or the GitHub web interface.sort is provided.application/vnd.github.text-match+json to include text match metadata).Output
Search commits
Search commits
GITHUB_SEARCH_COMMITSFinds commits on GitHub using a query string (q) supporting keywords and qualifiers, with options for sorting and pagination.Input Parameters
Output
GitHub GraphQL Search
GitHub GraphQL Search
GITHUB_SEARCH_GITHUB_GRAPHQLTool to perform GitHub GraphQL searches across issues, pull requests, repositories, users, and discussions. Returns up to 1,000 results with cursor-based pagination. Use when you need structured search results with specific fields.Input Parameters
Output
Search issues and pull requests
Search issues and pull requests
GITHUB_SEARCH_ISSUESSearches GitHub issues and pull requests using keywords and qualifiers, with sorting and pagination. Results are limited to accessible repositories and may be incomplete or subject to GitHub search limits.Input Parameters
repo:owner/repo, user:username, org:orgname, author:username, assignee:username, mentions:username, commenter:username, involves:username, label:labelname, milestone:title, state:open|closed, type:pr|issue, is:pr|issue|open|closed|merged|unmerged|locked|unlocked|draft, in:title|body|comments, created:YYYY-MM-DD, updated:YYYY-MM-DD, closed:YYYY-MM-DD, merged:YYYY-MM-DD, no:label|milestone|assignee, language:language, comments:n, reactions:n, interactions:n, project:number, archived:true|false, reviewed-by:username. Use comparison operators (>, <, >=, <=, ..) with numeric/date qualifiers. Multiple terms use implicit AND; quote exact phrases. Example: ‘repo:owner/repo is:issue state:open label:bug’Output
Search issues and pull requests
Search issues and pull requests
GITHUB_SEARCH_ISSUES_AND_PULL_REQUESTSSearches GitHub for issues and pull requests using keywords and qualifiers, with sorting and pagination. Standalone issue or pull request type filters must be combined with another term; @me is resolved by GitHub.Input Parameters
sort is also provided.Output
Search labels
Search labels
GITHUB_SEARCH_LABELSSearches for labels within a GitHub repository by keywords in their names or descriptions.Input Parameters
sort is also specified. Defaults to ‘desc’.Output
Search repositories
Search repositories
GITHUB_SEARCH_REPOSITORIESSearches GitHub repositories using a flexible query (keywords, qualifiers) with sorting, ordering, and pagination. IMPORTANT: The ‘q’ parameter (search query) is REQUIRED and must always be provided.Input Parameters
language:LANG, stars:N, stars:>N, forks:N, size:N (KB), topic:TOPIC, license:LICENSE, created:DATE, pushed:DATE, is:public|private, archived:true|false, in:name|description|readme, user:USERNAME, org:ORGNAME. Must use real GitHub usernames/orgs (e.g., user:octocat), not placeholders. Queries with logical operators must include at least one plain keyword; topic:solana OR topic:ethereum fails, use solana OR ethereum stars:>100 instead.per_page to fetch subsequent sets of results. See GitHub API documentation for more on pagination.stars, forks, help-wanted-issues, updated (recency of update), or created (creation date). If not provided, results are sorted by GitHub’s default ‘best match’ ranking.desc for descending or asc for ascending. This parameter is only effective when sort is also specified. Defaults to desc.Output
Search topics
Search topics
GITHUB_SEARCH_TOPICSFinds topics on GitHub using keywords and qualifiers with GitHub’s search syntax, supporting pagination.Input Parameters
Output
Search users
Search users
GITHUB_SEARCH_USERSSearches for users on GitHub by criteria like username, email, location, followers, or repository associations, using a flexible query string q.Input Parameters
username, location, followers). See examples for syntax.Output
Set admin branch protection
Set admin branch protection
Set app access restrictions
Set app access restrictions
GITHUB_SET_APP_ACCESS_RESTRICTIONSReplaces the list of GitHub Apps permitted to push to a protected branch; the branch must have push restrictions configured, and apps must be installed with contents write permission on an eligible organization repository. A 404 returns an empty app list with an explanatory message.Input Parameters
Output
Set a repository subscription
Set a repository subscription
GITHUB_SET_A_REPOSITORY_SUBSCRIPTIONSets the authenticated user’s notification subscription for a repository.Input Parameters
.git extension. The name is not case-sensitive.true, this repository will be ignored, and the subscribed parameter will be disregarded (effectively setting subscribed to false).true to watch the repository, false to unwatch. This parameter is overridden if ignored is set to true.Output
Set a thread subscription
Set a thread subscription
GITHUB_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.Input Parameters
True blocks notifications; False allows them if otherwise subscribed.Output
Set default workflow permissions for an organization
Set default workflow permissions for an organization
GITHUB_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.Input Parameters
true) can be a security risk. If omitted, the current setting is preserved.Output
Set default workflow permissions for a repository
Set default workflow permissions for a repository
GITHUB_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.Input Parameters
.git extension. This name is not case sensitive.Output
Set primary email visibility
Set primary email visibility
GITHUB_SET_EMAIL_VISIBILITYSets the visibility (‘public’ or ‘private’) of the authenticated user’s primary email address on GitHub, if one is configured.Input Parameters
Output
Set GitHub Actions permissions for an organization
Set GitHub Actions permissions for an organization
GITHUB_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.Input Parameters
Output
Set github actions permissions for a repository
Set github actions permissions for a repository
GITHUB_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.Input Parameters
.git extension. This field is not case-sensitive.True to enable, False to disable.all (all actions/workflows allowed), local_only (only from this repository), or selected (configured in settings). Optional; inherits from organization/enterprise or GitHub defaults if omitted.Output
Set interaction restrictions for an organization
Set interaction restrictions for an organization
GITHUB_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.Input Parameters
one_day. A new limit overwrites any existing one.Output
Set interaction restrictions for a repository
Set interaction restrictions for a repository
GITHUB_SET_INTERACTION_RESTRICTIONS_FOR_A_REPOSITORYTemporarily limits which GitHub users (e.g., existing_users, contributors_only) can interact (comment, open issues, create pull requests) in a repository for a specified duration.Input Parameters
Output
Set interaction restrictions for your public repositories
Set interaction restrictions for your public repositories
GITHUB_SET_INTERACTION_RESTRICTIONS_FOR_YOUR_PUBLIC_REPOSSets or updates temporary interaction restrictions for all public repositories owned by the authenticated user, overriding any repository-specific limits.Input Parameters
one_day if not provided.Output
Set labels for an issue
Set labels for an issue
GITHUB_SET_LABELS_FOR_AN_ISSUEReplaces all existing labels on a GitHub issue with a new set of labels.Input Parameters
.git extension. The name is not case sensitive.Output
Set custom OIDC subject claim template
Set custom OIDC subject claim template
GITHUB_SET_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.Input Parameters
include_claim_keys); if false, a custom template defined by include_claim_keys is used.use_default is false. Consult GitHub’s OIDC documentation for supported claim keys.Output
Set allowed actions and workflows for an organization
Set allowed actions and workflows for an organization
GITHUB_SET_ORG_ALLOWED_ACTIONSSets the GitHub Actions permissions for an existing organization, specifying allowed GitHub-owned actions, verified creator actions, and action/workflow patterns from public repositories.Input Parameters
monalisa/octocat@*, monalisa/*); supports wildcards, tags, SHAs.Output
Set custom labels for a self-hosted runner for an organization
Set custom labels for a self-hosted runner for an organization
GITHUB_SET_ORG_RUNNER_LABELSSets the custom labels for a self-hosted runner in an organization; this operation does not affect default system-assigned labels (e.g., ‘self-hosted’, ‘linux’, ‘x64’).Input Parameters
Output
Set repo allowed actions
Set repo allowed actions
GITHUB_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).Input Parameters
.git extension. The name is not case-sensitive.Output
Set custom labels for repo runner
Set custom labels for repo runner
Set selected repositories for an organization variable
Set selected repositories for an organization variable
GITHUB_SET_SELECTED_REPOS_FOR_ORG_VARIABLEReplaces the list of repositories that can access an organization-level variable; the variable’s visibility must be ‘selected’.Input Parameters
Output
Set selected repositories for an organization secret
Set selected repositories for an organization secret
GITHUB_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’. Prerequisites: - The organization secret must already exist - The secret’s visibility must be set to ‘selected’ (not ‘all’ or ‘private’) - Requires admin:org scope or actions secrets fine-grained permission This action completely replaces the repository access list. To add or remove individual repositories without affecting others, use the dedicated add/remove repository actions instead.Input Parameters
Output
Set selected repositories for a user secret
Set selected repositories for a user secret
GITHUB_SET_SELECTED_REPOSITORIES_FOR_A_USER_SECRETDefines the list of repositories permitted to access a specific Codespaces secret for the authenticated user.Input Parameters
Output
Set status check contexts
Set status check contexts
GITHUB_SET_STATUS_CHECK_CONTEXTSReplaces required status check contexts for a protected branch, requiring admin permissions; an empty contexts array removes all checks.Input Parameters
Output
Set team access restrictions
Set team access restrictions
GITHUB_SET_TEAM_ACCESS_RESTRICTIONSReplaces the list of teams with push access to a protected branch. This action sets (replaces) the teams that have push access to a protected branch. Unlike ‘Add team access restrictions’ (POST), this action replaces the entire list rather than adding to it. Use an empty list to remove all team restrictions. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must exist in the organization and have repository accessInput Parameters
.git extension. This value is not case-sensitive.Output
Set user access restrictions
Set user access restrictions
GITHUB_SET_USER_ACCESS_RESTRICTIONSReplaces the list of users with push access to a protected branch in an organization repository. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must already have protection rules with restrictions enabled - This REPLACES (not adds to) the existing list of users with push access - Users must have write access to the repository to be added - The combined total of users, apps, and teams is limited to 100 items - To add users without replacing, use the ‘add_user_access_restrictions’ action insteadInput Parameters
.git extension. This name is not case-sensitive.Output
Set User Interaction Limit (GraphQL)
Set User Interaction Limit (GraphQL)
GITHUB_SET_USER_INTERACTION_LIMIT_GRAPH_QLSet interaction limits on a specified user’s public repositories using GraphQL, temporarily restricting who can comment, open issues, or create pull requests.Input Parameters
Output
Set workflow access level outside repository
Set workflow access level outside repository
GITHUB_SET_WORKFLOW_EXTERNAL_ACCESSSets the access level for workflows outside a repository to use actions and reusable workflows within that repository.Input Parameters
none: Actions and reusable workflows are accessible only from workflows within this repository. - user: Actions and reusable workflows can be shared with other private repositories owned by the same user. - organization: Actions and reusable workflows can be shared with other repositories within the same organization.Output
Star a gist
Star a gist
GITHUB_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.Input Parameters
Output
Star a specified repository (requires owner and repo)
Star a specified repository (requires owner and repo)
GITHUB_STAR_A_REPOSITORY_FOR_THE_AUTHENTICATED_USERStars a specified repository (identified by owner and repo name) for the authenticated user; this action is idempotent and succeeds even if the repository is already starred. Requires explicit repository identification via owner and repo parameters.Input Parameters
.git extension. This field is not case-sensitive.Output
Start a codespace for the authenticated user
Start a codespace for the authenticated user
GITHUB_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’.Input Parameters
Output
Stop a codespace for an organization user
Stop a codespace for an organization user
GITHUB_STOP_A_CODESPACE_FOR_AN_ORGANIZATION_USERStops a running codespace for an organization member. This action allows organization administrators to stop a codespace that belongs to a member of their organization. The codespace must be in a running state (e.g., ‘Available’) to be stopped. Required permissions: - OAuth/PAT: admin:org scope - Fine-grained tokens: ‘Organization codespaces’ (write) or ‘Codespaces lifecycle admin’ (write) Common HTTP responses: - 200: Codespace successfully stopped, returns codespace object - 304: Not modified (codespace already stopped) - 401: Authentication required - 403: Insufficient permissions (need admin:org) - 404: Organization, user, or codespace not foundInput Parameters
Output
Stop a codespace for the authenticated user
Stop a codespace for the authenticated user
Submit a review for a pull request
Submit a review for a pull request
GITHUB_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.Input Parameters
COMMENT events to provide context; can also supplement APPROVE or REQUEST_CHANGES actions.APPROVE, REQUEST_CHANGES, or COMMENT. An invalid/omitted event will result in an HTTP 422 error and set the review state to PENDING, requiring a subsequent valid submission.Output
Sync a fork branch with the upstream repository
Sync a fork branch with the upstream repository
GITHUB_SYNC_FORK_BRANCH_WITH_UPSTREAMSynchronizes 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.Input Parameters
.git extension. This field is not case-sensitive.Output
Test the push repository webhook
Test the push repository webhook
GITHUB_TEST_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.Input Parameters
X-GitHub-Hook-ID header of a webhook delivery or by listing repository webhooks.Output
Transfer a repository
Transfer a repository
GITHUB_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.Input Parameters
new_owner is an organization; teams must belong to the new_owner.Output
Unblock a user
Unblock a user
Unblock a user from an organization
Unblock a user from an organization
Unfollow a user
Unfollow a user
Unfollow organization
Unfollow organization
GITHUB_UNFOLLOW_ORGANIZATIONTool to unfollow a GitHub organization using GraphQL. Use when you need to stop following a specific organization on GitHub.Input Parameters
Output
Unfollow user
Unfollow user
GITHUB_UNFOLLOW_USERTool to unfollow a GitHub user using GraphQL. Use when you need to stop following a specific user on GitHub.Input Parameters
Output
Unlock an issue
Unlock an issue
GITHUB_UNLOCK_AN_ISSUEUnlocks a currently locked GitHub issue in the specified repository, allowing new comments and interactions.Input Parameters
.git extension. This value is not case-sensitive.Output
Unlock an organization repository
Unlock an organization repository
GITHUB_UNLOCK_ORGANIZATION_REPOSITORYUnlocks a repository that was locked for migration within a GitHub organization. This action is part of the organization migrations workflow. When you start a migration with lock_repositories=true, the source repositories are locked to prevent changes during export. After the migration is complete and applied to the target instance, use this action to unlock the repositories so they can be accessed or deleted. Requirements: - You must be an organization owner to unlock repositories - The repository must be currently locked as part of the specified migration - This endpoint does not work with GitHub App tokens or fine-grained personal access tokens Typical workflow: 1. Start an organization migration with POST /orgs/{org}/migrations 2. Wait for the migration to complete (state: “exported”) 3. Apply the migration to your target instance 4. Unlock each migrated repository using this action 5. Delete the source repositories if no longer neededInput Parameters
Output
Unlock a user repository
Unlock a user repository
Unstar a gist
Unstar a gist
GITHUB_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.Input Parameters
Output
Unstar a repository
Unstar a repository
Update a check run
Update a check run
GITHUB_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. NOTE: This endpoint requires GitHub App authentication with ‘checks:write’ permission - OAuth tokens and personal access tokens cannot update check runs.Input Parameters
waiting, pending, or requested.label, identifier, and description.completed_at is provided or status is completed. Providing conclusion sets status to completed. Users cannot set stale.Output
Update a code scanning alert
Update a code scanning alert
GITHUB_UPDATE_A_CODE_SCANNING_ALERTUpdates a specific code scanning alert in a GitHub repository, primarily to change its state (e.g., ‘open’ or ‘dismissed’).Input Parameters
.git extension. The name is not case sensitive.dismissed_reason is mandatory.number field of the GET alerts API response.state is ‘dismissed’.Output
Update a commit comment
Update a commit comment
Update a custom organization role
Update a custom organization role
GITHUB_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.Input Parameters
Output
Update a deployment branch policy
Update a deployment branch policy
GITHUB_UPDATE_A_DEPLOYMENT_BRANCH_POLICYUpdates the name pattern of an existing deployment branch policy for a specific environment in a repository.Input Parameters
*) can be used but will not match /. For example, to match branches that begin with release/ and contain an additional single slash, use release/*/*. For more information about pattern matching syntax, refer to the Ruby File.fnmatch documentation (https://ruby-doc.org/core-2.5.1/File.html#method-c-fnmatch)..git extension. This name is not case-sensitive./ with %2F).Output
Update a discussion
Update a discussion
Update a discussion comment
Update a discussion comment
Update a gist
Update a gist
GITHUB_UPDATE_A_GISTUpdates a gist’s description, and/or its files (including content, filename changes, or deletion).Input Parameters
hello.py). For each file: update content, assign a new filename to rename (or both). To delete a file, set its value to null or an object without content or filename. Files not mentioned are preserved.Output
Update a gist comment
Update a gist comment
Update a label
Update a label
GITHUB_UPDATE_A_LABELUpdates an existing label’s name, color, or description within a specified repository.Input Parameters
Output
Update a milestone
Update a milestone
GITHUB_UPDATE_A_MILESTONEUpdates a repository milestone identified by owner, repository, and milestone number. It can modify the title, state, description, or due date; if state is omitted, it is sent as open.Input Parameters
.git extension. This field is not case-sensitive.YYYY-MM-DDTHH:MM:SSZ. If not provided, the due date will remain unchanged. To remove the due date, pass an empty string or null.Output
Update an environment variable
Update an environment variable
GITHUB_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.Input Parameters
.git extension. The name is not case sensitive./ with %2F).Output
Update an issue
Update an issue
GITHUB_UPDATE_AN_ISSUEUpdates an existing GitHub issue’s title, body, state, milestone, labels, or assignees. Empty lists can clear labels or assignees; null values are omitted from the update.Input Parameters
[] to remove all; omit to leave unchanged. Requires push access for changes.assignees. Send null to unassign, omit to leave unchanged.[] to remove all; omit to leave unchanged. Requires push access for changes.null to clear; omit to leave unchanged. Numeric ID recommended.state also changes. Valid reasons depend on the new state.Output
Update an issue comment
Update an issue comment
GITHUB_UPDATE_AN_ISSUE_COMMENTUpdates an existing comment on an issue or pull request within a specified repository. You can only update comments that the authenticated user has permission to edit. The comment_id can be obtained from the list_issue_comments or get_an_issue_comment actions.Input Parameters
Output
Update an organization
Update an organization
GITHUB_UPDATE_AN_ORGANIZATIONUpdates an organization’s settings; changing security-related fields requires admin, owner, or security manager permissions. Omitted repository-permission, repository-creation, Pages, private-forking, and web-commit signoff settings are sent with the tool’s defaults and may change existing settings.Input Parameters
members_allowed_repository_creation_type.private option only on GitHub Enterprise Cloud. Deprecated; overrides members_can_create_repositories.secret_scanning_push_protection_custom_link_enabled is true and a push is blocked.Output
Update an organization variable
Update an organization variable
GITHUB_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.Input Parameters
selected_repository_ids. If omitted or null, visibility remains unchanged.visibility is set to ‘selected’. Ignored for other visibility values. If omitted when visibility=‘selected’, the API may reject the request or use existing repository access list.Output
Update an organization webhook
Update an organization webhook
GITHUB_UPDATE_AN_ORGANIZATION_WEBHOOKUpdates an existing organization’s webhook configuration, subscribed events, active status, or name. If active status is omitted, the request enables the webhook.Input Parameters
['*'] to subscribe to all events. See GitHub docs for available event types.X-GitHub-Hook-ID header of a webhook delivery.config properties (e.g., content_type, secret), as GitHub mandates url when config is modified.json or form). The API defaults to form if this field is not provided.Output
Update a project
Update a project
GITHUB_UPDATE_A_PROJECTUpdates an existing GitHub project (V2) attributes like title, description, visibility, and state. Note: This action uses GitHub’s Projects V2 GraphQL API. The legacy Projects (classic) REST API was sunset on April 1, 2025. The project is identified by its number (visible in the project URL) and owner (either a username or organization name). If no owner is specified, the authenticated user is assumed. At least one field to update must be provided.Input Parameters
True closes the project, False reopens it. If not provided, the state will not be changed.True makes it public (visible to everyone), False makes it private. If not provided, the visibility will not be changed.Output
Update a pull request
Update a pull request
GITHUB_UPDATE_A_PULL_REQUESTUpdates an existing pull request, allowing changes to attributes like title, body, state, base branch, and maintainer modification settings.Input Parameters
.git extension. This name is not case-sensitive.Output
Update a pull request branch
Update a pull request branch
GITHUB_UPDATE_A_PULL_REQUEST_BRANCHRequests an asynchronous update of an open pull request’s head branch by merging its base branch, if mergeable and repository merging is enabled. The result may instead report merge conflicts, an already up-to-date branch, or an expected head SHA mismatch.Input Parameters
Output
Update a reference
Update a reference
GITHUB_UPDATE_A_REFERENCEUpdates an existing Git reference (e.g., a branch or tag) to point to a specific commit SHA. By default, only allows fast-forward updates (where the new commit is a descendant of the current one). Set force=true to allow non-fast-forward updates that rewrite history. IMPORTANT: The reference must already exist - use ‘Create a reference’ action to create new refs.Input Parameters
false (default), the new commit must be a direct descendant of the current commit (fast-forward only) - this prevents accidental history rewriting. When true, allows moving the reference to any commit, even if it means rewriting history or moving backward. Set to true only when you need to force-push changes, reset a branch, or intentionally rewrite commit history.Output
Update a release
Update a release
GITHUB_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.Input Parameters
.git extension. This name is not case-sensitive.true to identify the release as a pre-release, or false for a full release. Default: false.true for newly published releases. legacy specifies that the latest release should be determined based on the release creation date and higher semantic version.tag_name already exists. Defaults to the repository’s default branch if omitted.Output
Update a release asset
Update a release asset
GITHUB_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.Input Parameters
.git extension. The name is not case sensitive.Output
Update a repository
Update a repository
GITHUB_UPDATE_A_REPOSITORYUpdates settings for an existing GitHub repository, such as name, description, visibility, merge strategies, and security configurations.Input Parameters
.git extension (not case-sensitive). MUST be a real repository that exists and is accessible - placeholder values like ‘your-repo-name’ will cause 404 errors.squash_merge_commit_title. If true, squash merge commits use PR title; otherwise, commit message.Output
Update a repository invitation
Update a repository invitation
GITHUB_UPDATE_A_REPOSITORY_INVITATIONUpdates an active repository invitation to modify the invited user’s permissions; the specified repository and invitation must exist.Input Parameters
.git extension. This name is not case sensitive.Output
Update a repository ruleset
Update a repository ruleset
GITHUB_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.Input Parameters
.git extension. This name is not case sensitive.type and optional parameters (e.g., [{'type': 'creation'}, {'type': 'pull_request', 'parameters': {'required_approving_review_count': 2}}]). Accepts both JSON format with double quotes or Python list syntax with single quotes. Refer to GitHub API documentation for available rule types and their parameters.disabled (ruleset is ignored), active (ruleset is enforced), or evaluate (allows testing rules before enforcement - GitHub Enterprise only).actor_id, actor_type (RepositoryRole, Team, Integration, OrganizationAdmin), and bypass_mode (always, pull_request). Accepts both JSON format with double quotes or Python list syntax with single quotes. Example: [{'actor_id': 1, 'actor_type': 'RepositoryRole', 'bypass_mode': 'always'}].~DEFAULT_BRANCH targets the default branch; ~ALL targets all branches.Output
Update a repository variable
Update a repository variable
GITHUB_UPDATE_A_REPOSITORY_VARIABLEUpdates the name and/or value of an existing GitHub Actions variable in a repository.Input Parameters
Output
Update a repository webhook
Update a repository webhook
GITHUB_UPDATE_A_REPOSITORY_WEBHOOKUpdates the URL, content type, secret, SSL verification, events, or active status of an existing repository webhook. The active status defaults to true when omitted.Input Parameters
add_events/remove_events for incremental changes. See GitHub webhook event payloads docs for available event types.Output
Update a team
Update a team
GITHUB_UPDATE_A_TEAMUpdates a team’s settings (e.g., name, description, privacy, parent team) within a GitHub organization, identified by its slug and organization name.Input Parameters
privacy intact. When a team is nested, the privacy for parent teams cannot be secret. - For a non-nested team: - secret: Visible only to organization owners and members of this team. - closed: Visible to all members of this organization. - public: Visible to all members of this organization (equivalent to closed). - For a parent or child team: - closed: Visible to all members of this organization. - public: Visible to all members of this organization (equivalent to closed).null for this field (e.g., by setting this parameter to Python None). If this parameter is not provided in the request, the current parent team, if any, remains unchanged.notification_setting intact. - notifications_enabled: Team members receive notifications when the team is @mentioned. - notifications_disabled: No one receives notifications for team @mentions.Output
Update branch protection
Update branch protection
GITHUB_UPDATE_BRANCH_PROTECTIONUpdates branch protection settings for a specific existing repository branch; wildcard branch names are not supported. Unspecified status checks, admin enforcement, pull request reviews, and push restrictions are sent as null and may be disabled; unspecified user, team, or app lists within supplied push restrictions are sent empty.Input Parameters
True to enforce for admins, or None/null to disable.True, push restrictions also apply to creating matching new branches, unless pusher has explicit push access.slugs with push access. Cannot be used with restrictions_users or restrictions_teams. Empty list removes all.slugs with push access. Cannot be used with restrictions_apps or restrictions_users. Empty list removes all.logins with push access. Cannot be used with restrictions_apps or restrictions_teams. Empty list removes all.context string and optionally an app_id integer. Mutually exclusive with contexts - use one or the other, not both.True, merges are blocked if the head branch is behind the base branch.checks for finer control. Mutually exclusive with checks - use one or the other, not both.Output
Update a code scanning default setup configuration
Update a code scanning default setup configuration
GITHUB_UPDATE_CODE_SCANNING_DEFAULT_SETUPUpdates the default setup configuration for code scanning in a repository; GitHub Advanced Security must be enabled for the repository.Input Parameters
Output
Update a codespace for the authenticated user
Update a codespace for the authenticated user
GITHUB_UPDATE_CODESPACEUpdates 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.Input Parameters
Output
Update Git LFS Preference
Update Git LFS Preference
GITHUB_UPDATE_GIT_LFS_PREFERENCESets the Git Large File Storage (LFS) preference for a repository during a source import. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports.Input Parameters
.git extension. This field is not case-sensitive.opt_in enables Git LFS, storing large files. opt_out disables Git LFS, removing large files during the import.Output
Update issue type
Update issue type
Update a webhook configuration for an organization
Update a webhook configuration for an organization
GITHUB_UPDATE_ORGANIZATION_WEBHOOK_CONFIGURATIONUpdates the configuration (URL, content type, secret, SSL verification) for an existing webhook within a specified organization.Input Parameters
1 to disable SSL certificate verification for the webhook URL, or 0 to enable. Defaults to 0.Output
Update an existing project card (Classic - Deprecated)
Update an existing project card (Classic - Deprecated)
GITHUB_UPDATE_PROJECT_CARDUpdates an existing project card’s note and/or archived status (GitHub Classic Projects). DEPRECATION NOTICE: GitHub Projects (classic) and its REST API were sunset on April 1, 2025. This action will return 404 for most requests on GitHub.com. However, it may still work on GitHub Enterprise Server instances where classic projects are enabled. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/Input Parameters
null to clear the note. If omitted, the note remains unchanged.true to archive the card, false to unarchive it. If omitted, the archived status remains unchanged.Output
Update an existing project column (Classic - Deprecated)
Update an existing project column (Classic - Deprecated)
GITHUB_UPDATE_PROJECT_COLUMNUpdates the name of an existing column, identified by column_id, in a GitHub project (classic). DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. This action will return a 404 error on GitHub.com. For new projects, use GitHub Projects V2 which uses the GraphQL API instead. See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/Input Parameters
Output
Update a review for a pull request
Update a review for a pull request
Update a review comment for a pull request
Update a review comment for a pull request
GITHUB_UPDATE_PULL_REQUEST_REVIEW_COMMENTUpdates the body of an existing review comment on a pull request.Input Parameters
.git extension. This field is not case-sensitive.Output
Update pull request review protection
Update pull request review protection
GITHUB_UPDATE_PULL_REQUEST_REVIEW_PROTECTIONUpdates pull request review protection settings for a branch, including required approvals, review dismissal, and bypass allowances. The last-push approval setting defaults to false and is sent even when omitted; branch protection features must be available for the repository.Input Parameters
true, pull requests affecting files with code owners require their review. See about code owners.true, the most recent push requires approval by someone other than the pusher (GitHub Enterprise feature).Output
Update repository preferences for check suites
Update repository preferences for check suites
GITHUB_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.Input Parameters
.git extension. The name is not case sensitive.app_id (integer: the ID of the GitHub App) and a setting (boolean: true to enable automatic triggers for that app on code push, false to disable). Example: ’[{“app_id”: 12345, “setting”: true}]‘Output
Update a webhook configuration for a repository
Update a webhook configuration for a repository
GITHUB_UPDATE_REPOSITORY_WEBHOOK_CONFIGURATIONUpdates the configuration (e.g., payload URL, content type, secret, SSL verification) for an existing webhook in a specified repository.Input Parameters
X-Hub-Signature-256 header to verify authenticity.X-GitHub-Hook-ID header of a webhook delivery.json, form). GitHub defaults to form if this field is not provided.Output
Update resource access with tokens
Update resource access with tokens
GITHUB_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. AUTHENTICATION REQUIREMENT: This endpoint requires GitHub App authentication with ‘Personal access tokens’ organization permissions (write). Standard personal access tokens CANNOT use this endpoint. The GitHub App must also have access to the organization.Input Parameters
Output
Update status check protection
Update status check protection
GITHUB_UPDATE_STATUS_CHECK_PROTECTIONUpdates required status checks for a branch, optionally requiring it to be up-to-date before merging.Input Parameters
.git extension. This name is not case-sensitive.context (string) and an optional app_id (integer). Example: [{"context": "continuous-integration/jenkins", "app_id": 12345}]checks instead of contexts. Can be provided as a single string or a list of strings.Output
Update Subscription
Update Subscription
GITHUB_UPDATE_SUBSCRIPTIONTool to update notification subscription state for issues, pull requests, or discussions. Use when you need to subscribe, unsubscribe, or ignore notifications for a specific GitHub item.Input Parameters
Output
Update the authenticated user
Update the authenticated user
GITHUB_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.Input Parameters
null to clear the existing blog URL. For example, ‘https://github.blog’.null to clear the existing company. For example, ‘GitHub’.null to clear the existing location. For example, ‘San Francisco’.null to clear the existing Twitter username. For example, ‘github’.Output
Revoke Token Organization Access
Revoke Token Organization Access
GITHUB_UPDATE_TOKEN_ORG_ACCESSRevokes a fine-grained personal access token’s access to a specified GitHub organization. This operation requires a GitHub App with the organization’s ‘Personal access tokens’ write permission; personal access tokens cannot call it. List the organization’s resource access tokens to find the token ID.Input Parameters
Output
Update User List
Update User List
GITHUB_UPDATE_USER_LISTTool to update an existing GitHub user list. Use when you need to modify the name, description, or privacy settings of a user list.Input Parameters
Output
Update user lists for item
Update user lists for item
GITHUB_UPDATE_USER_LISTS_FOR_ITEMTool to update which of the viewer’s lists an item belongs to on GitHub. Use when you need to add an item (repository, issue, pull request, etc.) to specific user lists or move it between lists.Input Parameters
Output
Update Project V2 Item for User
Update Project V2 Item for User
GITHUB_UPDATE_USER_PROJECT_ITEMTool to update a field value for an item in a user’s GitHub ProjectV2. Use when you need to modify a field value of an existing project item.Input Parameters
Output
Change User Status
Change User Status
GITHUB_UPDATE_USER_STATUSTool to update your status on GitHub. Use when you need to set or clear your GitHub profile status with an emoji, message, and availability indicator.Input Parameters
Output
Upload a release asset
Upload a release asset
GITHUB_UPLOAD_RELEASE_ASSETTool to upload a binary asset to an existing GitHub release. Use when you need to attach files like installers or backups to a release programmatically.Input Parameters
Output
Upload an analysis as sarif data
Upload an analysis as sarif data
GITHUB_UPLOAD_SARIF_ANALYSISUploads 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.Input Parameters
refs/heads/<branch name>, refs/tags/<tag>, refs/pull/<number>/merge, or refs/pull/<number>/head.YYYY-MM-DDTHH:MM:SSZ.Output
Create or update repository custom property values
Create or update repository custom property values
GITHUB_UPSERT_REPO_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.Input Parameters
.git extension. This name is not case sensitive.property_name (string identifying the custom property) and value (the value for the property, which can be a string, number, or a single-select option, matching the property’s defined type). Example: ’[{“property_name”: “environment”, “value”: “production”}]‘Output
Validate credential
Validate credential
Verify dev container permissions accepted
Verify dev container permissions accepted
Triggers
New Workflow Artifact Created
New Workflow Artifact Created
GITHUB_ARTIFACT_CREATED_TRIGGERType: pollTriggers when a new workflow artifact is created in a GitHub repository.Monitors for newly created GitHub Actions workflow artifacts. Optionally filters by artifact name to restrict monitoring to specific artifacts.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Branch Changed
Branch Changed
GITHUB_BRANCH_CHANGED_TRIGGERType: pollTriggers when a GitHub branch changes.Monitors a specific branch for:- New commits pushed (head commit SHA changes)
- Protection status toggled (branch becomes protected or unprotected)
- Protection settings changed, including: required status checks and their enforcement level, admin enforcement, required pull request reviews (dismiss stale reviews, code owner reviews, approving review count, last push approval), required linear history, force push allowance, deletion allowance, conversation resolution, branch locking, and fork syncing.
Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
New Branch Created
New Branch Created
GITHUB_BRANCH_CREATED_TRIGGERType: pollTriggers when a new branch is created in a GitHub repository.Detects newly created branches. Deleted branches do not fire events.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Check Run Status / Conclusion Changed
Check Run Status / Conclusion Changed
GITHUB_CHECK_RUN_STATUS_CHANGED_TRIGGERType: pollTriggers when a specific GitHub check run changes its status or conclusion.Monitors a single check run for changes to: status (queued, in_progress, completed, etc.), conclusion (success, failure, neutral, cancelled, skipped, timed_out, action_required), started_at, and completed_at.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Check Suite Status / Conclusion Changed
Check Suite Status / Conclusion Changed
GITHUB_CHECK_SUITE_STATUS_CHANGED_TRIGGERType: pollTriggers when a GitHub check suite changes its status or conclusion for a given ref.Monitors all check suites associated with a git reference (branch, tag, or commit SHA) for changes to status (queued, in_progress, completed, etc.) and conclusion (success, failure, neutral, cancelled, skipped, timed_out, action_required, startup_failure, stale). Optionally filters by GitHub App ID.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
New Code Scanning Alert Created
New Code Scanning Alert Created
GITHUB_CODE_SCANNING_ALERT_CREATED_TRIGGERType: pollTriggers when a new code scanning alert is created in a repository.Fires an event for each newly created code scanning alert detected in the configured repository. Alerts can be filtered by Git reference, scanning tool, state, and severity. The payload includes the alert number, rule details, tool information, state, severity, and the location of the most recent instance.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
New Repository Collaborator Added
New Repository Collaborator Added
GITHUB_COLLABORATOR_ADDED_TRIGGERType: pollTriggers when a new collaborator is added to a GitHub repository.Monitors the full list of collaborators on a repository and fires an event for each newly added collaborator. The payload includes the collaborator’s GitHub username, account ID, profile URL, avatar URL, permission flags (pull, triage, push, maintain, admin), and assigned role name.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Commit Event
Commit Event
New Deployment Created
New Deployment Created
GITHUB_DEPLOYMENT_CREATED_TRIGGERType: pollTriggers when a new deployment is created in a GitHub repository.Fires an event for each newly created deployment detected in the configured repository. Deployments can optionally be filtered by target environment. The payload includes the deployment ID, commit SHA, ref, task, environment, creator details, and timestamps.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
GitHub Deployment State Changed
GitHub Deployment State Changed
GITHUB_DEPLOYMENT_STATE_CHANGED_TRIGGERType: pollTriggers when a specific GitHub deployment’s fields change.Monitors the following aspects of a single deployment:environment— the target environment nameoriginal_environment— the original environment name before normalizationdescription— the human-readable deployment descriptiontask— the deployment task namesha— the commit SHA being deployedref— the branch, tag, or SHA reference being deployedupdated_at— the last-updated timestamptransient_environment— whether the environment is temporaryproduction_environment— whether this is a production deployment
Configuration
GET /repos/{owner}/{repo}/deployments or from your CI/CD output.polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
New Deployment Status Created
New Deployment Status Created
GITHUB_DEPLOYMENT_STATUS_CREATEDType: pollTriggers when a new deployment status is created for a specific deployment.Fires an event for each newly created deployment status on the monitored deployment. Deployment statuses represent state transitions such as pending, in_progress, success, failure, error, inactive, and queued. The payload includes the status state, creator, environment, description, timestamps, and relevant URLs.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Follower Changes
Follower Changes
New Git Reference Created
New Git Reference Created
GITHUB_GIT_REFERENCE_CREATED_TRIGGERType: pollTriggers when a new Git reference (branch or tag) matching a specified prefix is created in a repository.Fires an event for each newly created branch or tag whose name matches the configured prefix. Use ref_prefix to control what is monitored:heads/to watch all branchesheads/feature/to watch only feature branchestags/to watch all tagstags/vto watch tags starting with ‘v’
Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Issue Added Event
Issue Added Event
New Issue Assigned to Me
New Issue Assigned to Me
GITHUB_ISSUE_ASSIGNED_TO_ME_TRIGGERType: pollTriggers when a new issue is assigned to the authenticated user.Fires an event for each GitHub issue that is newly assigned to the authenticated user. Pull requests are automatically excluded — only true issues are emitted. Issues can optionally be filtered by labels and state. The payload includes the issue number, title, body, state, labels, assignees, creator, repository details, and timestamps.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
GitHub Issue Comment Changed
GitHub Issue Comment Changed
GITHUB_ISSUE_COMMENT_CHANGED_TRIGGERType: pollTriggers when a specific GitHub issue comment changes.Monitors the following fields for changes:body— the text content of the comment (detects edits)updated_at— the last-updated timestampreactions_*— all individual reaction counts (thumbs up/down, laugh, confused, heart, hooray, eyes, rocket) and the total count
changed_fields list indicating exactly which fields were modified.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
New GitHub Issue Comment
New GitHub Issue Comment
GITHUB_ISSUE_COMMENT_CREATED_TRIGGERType: pollTriggers when a new comment is added to a specific GitHub issue.Only genuinely new comments are emitted; edits to existing comments do not produce duplicate events. The payload includes the comment ID, text body, author details, timestamps, and direct links to the comment on GitHub.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
New Issue Created
New Issue Created
GITHUB_ISSUE_CREATED_TRIGGERType: pollTriggers when a new issue is created in a GitHub repository.Pull requests are automatically excluded — only true issues produce events. Results can be filtered by labels, assignee, creator, and mentioned user.The payload includes the issue number, title, body, state, labels, assignees, comment count, creator details, timestamps, and direct links to the issue on GitHub.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
New Issue Event
New Issue Event
GITHUB_ISSUE_EVENT_OCCURRED_TRIGGERType: pollTriggers when a new issue event occurs in a GitHub repository.Covers all issue timeline events such as issues being closed, reopened, assigned, unassigned, labeled, unlabeled, milestoned, demilestoned, renamed, locked, or unlocked. Events can optionally be filtered by type.The payload includes the event type, timestamp, the actor who triggered the event, the affected issue details, and any associated commit references.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
GitHub Issue Labels Changed
GitHub Issue Labels Changed
GITHUB_ISSUE_LABEL_CHANGED_TRIGGERType: pollTriggers when the labels on a specific GitHub issue change.Fires whenever a label is added to, removed from, or has its metadata (color, description) modified on the monitored issue. The payload includes:current_labels— the full set of labels currently on the issueadded_labels— labels that were newly addedremoved_label_names— names of labels that were removedchanged_label_names— labels whose metadata changed without being added or removed
Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Issue State / Properties Changed
Issue State / Properties Changed
GITHUB_ISSUE_STATE_CHANGED_TRIGGERType: pollTriggers when a specific GitHub issue changes any of its tracked properties.Monitored properties: state (open/closed), state_reason, title, body, assignees, labels, milestone, lock status, active_lock_reason, comment count, and closed_at timestamp.When a change is detected, the payload includes the full current issue details, the list of changed field names, and their previous values.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Issue Updated
Issue Updated
GITHUB_ISSUE_UPDATED_TRIGGERType: pollTriggers when an existing issue is updated in a GitHub repository.Monitors issues for any changes such as title edits, body edits, label changes, assignee changes, state transitions (opening, closing, reopening), milestone updates, and comment additions. Only pre-existing issues that receive updates are emitted; newly created issues are excluded. Pull requests are also excluded — only true issues fire events.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Label Added Event
Label Added Event
New Stargazer Added
New Stargazer Added
GITHUB_NEW_STARGAZER_ADDED_TRIGGERType: pollTriggers when a new user stars a GitHub repository.Emits an event for each new stargazer detected on the monitored repository.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
New Pull Request Review Comment
New Pull Request Review Comment
GITHUB_PR_REVIEW_COMMENT_CREATED_TRIGGERType: pollTriggers when a new inline review comment is added to a specific GitHub pull request.Monitors all review comments across all reviews on the specified pull request and emits an event for each newly created comment. Edits to existing comments do not fire new events.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
New Commit Added to Pull Request
New Commit Added to Pull Request
GITHUB_PULL_REQUEST_COMMIT_ADDED_TRIGGERType: pollTriggers when a new commit is pushed to a specific pull request.Monitors all commits on the specified pull request and emits an event for each newly added commit. This covers force-pushes and additional commits pushed to the PR’s head branch.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
New Pull Request Created
New Pull Request Created
GITHUB_PULL_REQUEST_CREATEDType: pollTriggers when a new pull request is created in GitHub, matching the optional configured filters.Emits an event for each newly created pull request. Supports filtering by repository, owner/organisation, author, assignee, label, state, base branch, head branch, and draft status.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Pull Request Event
Pull Request Event
GitHub Pull Request Reviewers Changed
GitHub Pull Request Reviewers Changed
GITHUB_PULL_REQUEST_REVIEWERS_CHANGED_TRIGGERType: pollTriggers when the list of requested reviewers (users or teams) for a pull request changes — for example when a reviewer is added, removed, or re-requested.The payload includes the full current reviewer list (users and teams with details), which reviewers were added, which were removed, and the previous reviewer list for reference.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Pull Request Review Submitted
Pull Request Review Submitted
GITHUB_PULL_REQUEST_REVIEW_SUBMITTED_TRIGGERType: pollTriggers when a new review is submitted for a GitHub pull request.Emits an event for each newly submitted review on the monitored pull request, covering all review types: APPROVED, CHANGES_REQUESTED, COMMENTED, and DISMISSED.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Pull Request State / Properties Changed
Pull Request State / Properties Changed
GITHUB_PULL_REQUEST_STATE_CHANGED_TRIGGERType: pollTriggers when a specific GitHub pull request changes any of these tracked properties: state (open/closed), title, body, draft status, lock status, merge status, assignees, labels, requested reviewers, or milestone.The payload includes the full current PR details, the list of changed field names, and their previous values.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Pull Request Updated
Pull Request Updated
GITHUB_PULL_REQUEST_UPDATEDType: pollTriggers when an existing pull request is updated in a GitHub repository.Updates include title edits, description changes, label changes, assignee changes, reviewer requests, draft status changes, base branch changes, being closed, merged, or reopened. Only pre-existing PRs that receive an update will fire the trigger; newly created PRs are excluded.Supports optional filters: state, base branch, head branch, author, label, and draft status.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
GitHub Repository README Changed
GitHub Repository README Changed
GITHUB_README_CHANGED_TRIGGERType: pollTriggers when the README file in a specific repository directory changes.Monitors the README in a configurable directory and branch/tag/commit. The payload includes the current README metadata (filename, path, SHA, size, URLs), the previous and current git blob SHAs, and a list of which tracked fields changed.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
New GitHub Release Asset Added
New GitHub Release Asset Added
GITHUB_RELEASE_ASSET_ADDED_TRIGGERType: pollTriggers when a new asset is added to a specific GitHub release.Monitors a single release (identified by release ID) for newly uploaded assets such as binaries, archives, or checksum files. One event is emitted per new asset, containing full asset metadata.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
GitHub Release State Changed
GitHub Release State Changed
GITHUB_RELEASE_STATE_CHANGED_TRIGGERType: pollTriggers when a specific GitHub release (identified by tag name) changes.Monitors the release title, body/notes, draft flag, prerelease flag, published timestamp, target branch/commit, and the set of attached assets. The payload includes the full current release details, a list of which fields changed, and the previous values for comparison.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Repository Content Changed
Repository Content Changed
GITHUB_REPOSITORY_CONTENT_CHANGED_TRIGGERType: pollTriggers when the content of a file or directory in a GitHub repository changes.Monitors a specified path within a repository on a given branch or tag. For a single file, fires content_changed when the file is modified. For a directory, fires content_changed, content_added, or content_removed for modified, new, or deleted entries respectively.content.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Repository Notification Received
Repository Notification Received
GITHUB_REPOSITORY_NOTIFICATION_RECEIVED_TRIGGERType: pollTriggers when a new or newly updated notification thread appears for a specific GitHub repository.Monitors notifications for issues, pull requests, commits, releases, check suites, security alerts, and other repository activity. Supports filtering by read/unread status and by direct participation.Requires a Personal Access Token (classic) with the notificationsConfiguration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
New Repository Tag Created
New Repository Tag Created
GITHUB_REPOSITORY_TAG_CREATED_TRIGGERType: pollTriggers when a new tag is created in a GitHub repository.Monitors the repository’s tags and fires an event for each newly created tag. The payload includes the tag name, the commit SHA and URL it points to, and archive download URLs.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
New Secret Scanning Alert Detected
New Secret Scanning Alert Detected
GITHUB_SECRET_SCANNING_ALERT_DETECTED_TRIGGERType: pollTriggers when a new secret scanning alert is detected in a GitHub repository.Monitors open secret scanning alerts and fires an event for each newly detected alert. Supports filtering by secret type (e.g., personal access tokens, AWS keys) and by token validity status (active, inactive, unknown).The payload includes the alert number, secret type, validity status, resolution state, timestamps, URLs, and flags for push protection bypass, public exposure, and multi-repo detection.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Star Added Event
Star Added Event
New GitHub Actions Workflow Added
New GitHub Actions Workflow Added
GITHUB_WORKFLOW_ADDED_TRIGGERType: pollTriggers when a new GitHub Actions workflow is added to a repository.Monitors a repository’s GitHub Actions workflows and fires an event for each newly added workflow. The payload includes the workflow’s name, file path, state, creation and update timestamps, and URLs for the API, web interface, and status badge.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
New Workflow Job Added
New Workflow Job Added
GITHUB_WORKFLOW_JOB_ADDED_TRIGGERType: pollTriggers when a new job appears in a specific GitHub Actions workflow run.This is useful for detecting matrix-expanded jobs that are added after the initial workflow run creation, or any other scenario where jobs are dynamically added to an existing run.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Workflow Job State Changed
Workflow Job State Changed
GITHUB_WORKFLOW_JOB_STATE_CHANGEDType: pollTriggers when the status, conclusion, timestamps, runner assignment, or step details of a specific GitHub Actions workflow job change between polls.The payload includes the full current job state, a list of which fields changed, and the previous status/conclusion values for easy comparison.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
New Artifact Added to Workflow Run
New Artifact Added to Workflow Run
GITHUB_WORKFLOW_RUN_ARTIFACT_ADDEDType: pollTriggers when a new artifact is uploaded to a specific GitHub Actions workflow run.Monitors a single workflow run for newly added artifacts such as build outputs, test results, or coverage reports. Each new artifact detected fires a separate event.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
New Workflow Run Created
New Workflow Run Created
GITHUB_WORKFLOW_RUN_CREATEDType: pollTriggers when a new workflow run is created in a GitHub repository.Monitors the repository for any new workflow runs and fires an event for each one. Optional filters allow narrowing to a specific branch, actor, or event type.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
GitHub Workflow Run State Changed
GitHub Workflow Run State Changed
GITHUB_WORKFLOW_RUN_STATE_CHANGED_TRIGGERType: pollTriggers when a GitHub Actions workflow run’s status or conclusion changes.Monitors a single workflow run and fires an event whenever it transitions between states (e.g., queued to in_progress, or in_progress to completed) or when its conclusion is set (e.g., success, failure, cancelled).Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.