01
Triage incoming issues
- Webhook fires on every new issue
- Persona summarises and labels it
- Assigns the right engineer
GitHub
867 tools available · 46 triggers
GitHub is a code hosting platform for version control and collaboration, offering Git-based repository management, issue tracking, and continuous integration features
Connect GitHub to Definable to triage issues, review pull requests, monitor builds. Personas call GitHub's 867 tools (and react to 46 triggers) directly from chat or scheduled flows. Wire it into a triage, review, or release-management persona — every action runs scoped, reviewable, and logged.
Common workflows with GitHub
02
Auto-review PRs
- Pull the diff
- Run a code-review persona
- Post structured feedback as PR comment
03
Failing-build alerts
- CI sends a failure event
- Agent inspects logs and stack trace
- Drops a debug summary in Slack
04
Release notes from commits
- Read commits since last tag
- Group by type with the model
- Post to a changelog channel
GitHub actions 867
Every GitHub action below is a callable tool any Definable persona can invoke.
Abort Repository Migration
Tool to abort a repository migration that is queued or in progress. Use when you need to cancel an ongoing migration operation.
Accept a repository invitation
Accepts a PENDING repository invitation that has been issued to the authenticated user.
Add app access restrictions
Adds GitHub Apps to the list of apps allowed to push to a protected branch. 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.
Add a repository collaborator
Adds a GitHub user as a repository collaborator, or updates their permission if already a collaborator; `permission` applies to organization-owned repositories (personal ones default to 'push' and ignore this field), and an invitation may be created or permissions updated directly.
Add assignees to an issue
Adds assignees to a GitHub issue. This action only adds users - it does not remove existing assignees. Changes are silently ignored if the authenticated user lacks push access to the repository.
Add email for auth user
Adds one or more email addresses (which will be initially unverified) to the authenticated user's GitHub account; use this to associate new emails, noting an email verified for another account will error, while an existing email for the current user is accepted.
Add field to user project
Tool to add a custom field to a user-owned GitHub Projects V2 project. Use when you need to add fields like status, priority, or custom data to organize project items.
Add item to user project
Tool to add an issue or pull request to a user-owned GitHub project. Use when you need to add existing repository items to a project board.
Add labels to an issue
Adds labels (provided in the request body) to a repository issue; labels that do not already exist are created.
Add org runner labels
Adds new custom labels to an existing self-hosted runner for an organization; existing labels are not removed, and duplicates are not added.
Add or update team membership for a user
Adds a GitHub user to a team or updates their role (member or maintainer), inviting them to the organization if not already a member; idempotent, returning current details if no change is made.
Add or update team project permissions
Adds a classic project to a team or updates the team's permission on it. This endpoint grants or updates permissions for a team on a specific classic project (not Projects V2). The authenticated user must have admin permissions for the project. Both the team and project must belong to the same organization. Requirements: - The project must be a classic project (not GitHub Projects V2) - The authenticated user must have admin permissions on the project - The team and project must be in the same organization - Requires 'admin:org' scope for the authentication token Returns HTTP 204 No Content on success, 403 if project is not an org project, or 404 if the organization, team, or project is not found.
Add or update team repository permissions
Sets or updates a team's permission level for a repository within an organization; the team must be a member of the organization.
Add project collaborator
Adds a specified GitHub user as a collaborator to an existing organization project with a given permission level. Note: This endpoint is for organization projects (classic). You must be an organization owner or a project admin to add a collaborator. Classic projects are being deprecated in favor of the new Projects experience.
Add a repository to an app installation
Adds a repository to a GitHub App installation, granting the app access; requires authenticated user to have admin rights for the repository and access to the installation.
Add repo to org secret with selected access
Adds a repository to an existing organization-level GitHub Actions secret that is configured for 'selected' repository access.
Add selected repo to org secret
Grants an existing repository access to an existing organization-level Dependabot secret when the secret's visibility is set to 'selected'; the repository must belong to the organization, and the call succeeds without change if access already exists.
Add runner labels
Adds and appends custom labels to a self-hosted repository runner, which must be registered and active.
Add selected repository to an organization secret
Adds a repository to an organization secret's access list when the secret's visibility is 'selected'; this operation is idempotent.
Add selected repository to an organization variable
Grants a repository access to an organization-level GitHub Actions variable, if that variable's visibility is set to 'selected_repositories'.
Add a selected repository to a user secret
Grants a specified repository access to an authenticated user's existing Codespaces secret, enabling Codespaces created for that repository to use the secret.
Add social accounts for the authenticated user
Adds one or more social media links (which must be valid, full URLs for platforms supported by GitHub) to the authenticated user's public GitHub profile.
Add status check contexts
Adds status check contexts 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.
Add sub-issue to an issue
Tool to add a sub-issue to a parent GitHub issue using GraphQL. Use when you need to establish a parent-child relationship between issues. Requires the 'sub_issues' GraphQL feature to be enabled.
Add team access restrictions
Adds teams to the list of teams with push access to a protected branch. This action grants additional teams push access to a protected branch. Unlike 'Set team access restrictions' (PUT), this action adds to the existing list rather than replacing it entirely. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must exist in the organization and have repository access
Add user access restrictions
Adds users to the list of people allowed to push to a protected branch in an organization repository. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must already have protection rules with restrictions enabled - Users must have write access to the repository to be added - The combined total of users, apps, and teams is limited to 100 items
Add users to codespaces access for an organization
Adds organization members to the list of users granted Codespaces access billed to the organization. IMPORTANT: This endpoint requires the organization's Codespaces billing access to be set to 'selected_members' mode. If not already configured, use the GITHUB_MANAGE_ACCESS_CONTROL_FOR_ORGANIZATION_CODESPACES action first to set visibility to 'selected_members'.
Get GitHub API root
Retrieves a map of all top-level GitHub REST API resource URLs and their templates.
Approve a workflow run for a fork pull request
Approves a workflow run from a forked repository's pull request; call this when such a run requires manual approval due to workflow configuration.
Assign an organization role to a team
Assigns an existing organization-level role (identified by `role_id`) to a team (identified by `team_slug`) within a GitHub organization (`org`), provided the organization, team, and role already exist.
Assign an organization role to a user
Assigns a specific organization role to a user who is a member or an outside collaborator in a GitHub organization, using a valid role ID.
List Docker Migration Conflicting Packages
List Docker packages with migration conflicts for the authenticated user. This endpoint lists all Docker packages owned by the authenticated user that encountered namespace conflicts during the Docker-to-GitHub Container Registry (GHCR) migration. Conflicts occur when a package with the same name exists in both the legacy Docker registry and GHCR. IMPORTANT: The Docker registry for GitHub Packages was deprecated on Feb 24, 2025. This endpoint may return a 400 error with message 'Package migration for docker is no longer supported' as the migration period has ended. In this case, the action returns an informative response instead of failing. Use case: Identifying packages that require manual migration to GHCR. Required scope: read:packages (for OAuth and personal access tokens).
Block a user
Blocks an existing individual GitHub user (not an organization or your own account), preventing them from interacting with your account and repositories.
Block a user from an organization
Blocks a GitHub user from an organization, preventing their contributions, collaboration, and forking of the organization's repositories. Requires admin or 'Blocking users' organization permission (write access).
Cancel a GitHub Pages deployment
Cancels an existing, ongoing or queued GitHub Pages deployment for a repository using its `pages_deployment_id`.
Cancel sponsorship
Tool to cancel an active GitHub sponsorship using GraphQL. Use when you need to terminate a sponsorship relationship between a sponsor and a sponsorable entity. Either sponsor ID/login and sponsorable ID/login must be provided.
Cancel a workflow run
Cancels a workflow run in a GitHub repository if it is in a cancellable state (e.g., 'in_progress' or 'queued'). Returns 202 Accepted on success.
Check if a gist is starred
Checks if a gist is starred by the authenticated user. Returns `is_starred: true` if the gist is starred (HTTP 204), or `is_starred: false` if not starred (HTTP 404). Use this to verify star status before starring/unstarring a gist.
Check if pull request merged
Checks if a specified GitHub pull request has been merged, indicated by a 204 HTTP status (merged) or 404 (not merged/found).
Check if a user can be assigned
Verifies if a GitHub user can be assigned to issues in a repository; assignability is confirmed by an HTTP 204 (No Content) response, resulting in an empty 'data' field in the response.
Check if a user can be assigned to an issue
Checks if a specified GitHub user can be assigned to a given issue within a repository.
Check if a user follows another user
Checks if a GitHub user `username` follows `target_user`; returns a 204 HTTP status if true, 404 if not or if users are invalid.
Check if a user is blocked by the authenticated user
Checks if the specified GitHub user is blocked by the authenticated user; a 204 No Content response indicates the user is blocked, while a 404 Not Found indicates they are not.
Check if a user is blocked by an organization
Checks if a GitHub user is blocked by an organization. Returns is_blocked=True if the user is blocked (HTTP 204), or is_blocked=False if not blocked (HTTP 404). Requires 'Blocking users' organization permission (read access).
Check if a user is a repository collaborator
Checks if a user is a collaborator on a specified GitHub repository, returning a 204 status if they are, or a 404 status if they are not or if the repository/user does not exist.
Check if person is followed by authenticated user
Checks if the authenticated GitHub user follows a target GitHub user. Returns a structured response with is_following=True when following (HTTP 204), or is_following=False when not following (HTTP 404).
Check private vulnerability reporting status
Checks if private vulnerability reporting is enabled for the specified repository.
Check public organization membership
Tool to check if a user is a public member of an organization. Use when you need to verify public organization membership status.
Check team permissions for a project
Checks if a team has 'read', 'write', or 'admin' permissions for an organization's specific classic project, returning the project's details if access is confirmed.
Check team permissions for a repository
Checks a team's permissions for a specific repository within an organization, including permissions inherited from parent teams.
Check a token
Checks if a GitHub App or OAuth access_token is valid for the specified client_id and retrieves its details, typically to verify its active status and grants. 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.
Clear Project V2 Item Field Value
Tool to clear the value of a field for an item in a GitHub Project V2. Use when you need to remove or reset a field value (text, number, date, assignees, labels, single-select, iteration, or milestone fields).
Clear repository cache by key
Deletes GitHub Actions caches from a repository matching a specific `key` and an optional Git `ref`, used to manage storage or clear outdated/corrupted caches; the action succeeds even if no matching caches are found to delete.
Clear self-hosted runner org labels
Removes all custom labels from a self-hosted runner for an organization; default labels (e.g., 'self-hosted', 'linux', 'x64') will remain.
Commit Multiple Files
Tool to atomically create, update, or delete multiple files in a GitHub repository as a single commit. Uses Git Data APIs to avoid SHA mismatch conflicts that occur with the Contents API when multiple files are modified in parallel. Use when you need to make multi-file changes reliably. BRANCH CREATION: When committing to a new branch (e.g., 'fix/my-fix' or 'feature/new-feature'), you MUST provide 'base_branch' (typically 'main' or 'master') to create the branch from. If the branch already exists, base_branch is not needed. This action handles race conditions automatically: if the branch is updated by another commit between fetching the HEAD and updating the reference (resulting in a 422 'not a fast forward' error), the action will retry by refetching the HEAD and rebasing changes. Use max_retries to control this behavior.
Compare two commits
Compares two commit points (commits, branches, tags, or SHAs) within a repository or across forks, using `BASE...HEAD` or `OWNER:REF...OWNER:REF` format for the `basehead` parameter.
Configure JIT runner for an org
Generates a JIT configuration for a GitHub organization's new self-hosted runner to run a single job then unregister; requires admin:org scope and the runner_group_id must exist in the organization.
Configure OIDC subject claim template
Sets or updates the OIDC subject claim customization template for an existing GitHub organization by specifying which claims (e.g., 'repo', 'actor') 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.
Convert an organization member to outside collaborator
Converts an existing organization member, who is not an owner, to an outside collaborator, restricting their access to explicitly granted repositories.
Create a blob
Creates a Git blob in a repository, requiring content and encoding ('utf-8' or 'base64'). Requires write access to the repository.
Create a check run
Creates a new check run for a specific commit in a repository, used by external services to report status, detailed feedback, annotations, and images directly within the GitHub UI. NOTE: This endpoint requires GitHub App authentication - OAuth tokens and personal access tokens cannot create check runs.
Create a check suite
Creates a new check suite for a specific commit (`head_sha`) in an original repository (not a fork). IMPORTANT: This endpoint requires a GitHub App installation access token - OAuth tokens and classic personal access tokens cannot use this endpoint. GitHub dispatches a `check_suite` webhook event with the `requested` action upon success.
Create a codespace for the authenticated user
Creates a GitHub Codespace for the authenticated user, requiring a JSON request body with either `repository_id` (integer) or a `pull_request` object (containing `pull_request_number` (integer) and `repository_id` (integer)). This action allows users to set up a development environment quickly by creating a codespace from a specified repository or pull request.
Create a codespace from a pull request
Creates a GitHub Codespace for an open pull request in a Codespaces-enabled repository, with options to customize its configuration.
Create a codespace in a repository
Creates a GitHub Codespace for the authenticated user in a specified repository, which must be accessible and use a valid `devcontainer.json` if `devcontainer_path` is specified.
Create a commit
Creates a new commit in a GitHub repository; the `tree` SHA and any `parents` SHAs must already exist in the repository.
Create a commit comment
Creates a comment on a specific commit, or on a specific line if `path` and `position` are provided.
Create a commit status
Sets a commit's status (e.g., error, failure, pending, success from CI/CD) for a given SHA; max 1000 statuses per SHA/context.
Create a custom organization role
Creates a custom role with defined permissions within a GitHub organization.
Create a deploy key
Creates a deploy key for a repository; the repository must exist and be accessible, and the provided key must be a valid public SSH key.
Create a deployment
Creates a GitHub deployment for an existing repository, targeting a specific ref (branch, tag, or SHA) that must also exist within the repository.
Create a deployment branch policy
Creates a deployment branch or tag policy for an existing environment in a GitHub repository, using a Ruby File.fnmatch pattern (where `*` doesn't match `/`) to specify which branches or tags are deployable.
Create a deployment status
Creates a status for an existing deployment, updating its operational state, associated URLs, and description.
Create a discussion
Creates a new discussion post on a specific team's page within an organization.
Create a discussion comment
Creates a new comment on an existing team discussion within a GitHub organization.
Create a fork
Creates a fork of an accessible repository, optionally into a specific organization, with a new name, or copying only the default branch.
Create a gist
Creates a new gist on GitHub with provided files, an optional description, and public/secret visibility.
Create a gist comment
Creates a new comment on a specified GitHub gist.
Create a GitHub App from a manifest
Use this action to 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.
Create a github pages deployment
Creates a GitHub Pages deployment for a repository using a specified artifact and OIDC token, provided GitHub Pages is enabled and the artifact (containing static assets) is accessible.
Create a github pages site
Configures or updates GitHub Pages for a repository, setting build type and source; ensure a Pages workflow exists for 'workflow' `build_type`, or `source_branch` exists for 'legacy' or unspecified `build_type`. This action allows users to effectively manage their GitHub Pages site settings, specifying how the site is built and where the source files are located.
Create a label
Creates a new label in a specified GitHub repository, provided the repository exists and the user has write permissions.
Create a milestone
Creates a milestone in a GitHub repository for tracking progress on issues or pull requests; requires repository existence and user write permissions.
Create an autolink reference for a repository
Creates a repository autolink to automatically convert text references (e.g., 'TICKET-123') into hyperlinks, using a unique `key_prefix` and a `url_template` that includes `<num>`.
Create an environment variable
Creates an encrypted environment variable for a pre-existing environment within a GitHub repository; will fail if the variable name already exists.
Create an issue
Creates a new issue in a GitHub repository, requiring the repository to exist and have issues enabled; specific fields like assignees, milestone, or labels may require push access.
Create an issue comment
Creates a new comment on an existing GitHub issue or pull request within the specified repository.
Create an organization project
Creates a new classic project board within a specified GitHub organization. Note: This action uses GitHub's Projects (classic) REST API. The classic projects feature may be disabled in some organizations, and GitHub recommends migrating to Projects V2 (accessible via GraphQL API) for new projects. Requirements: - The authenticated user must be an organization member with project creation permissions - Classic projects must be enabled for the organization - Requires 'repo' and 'admin:org' or 'write:org' scopes
Create an organization repository
Creates a new repository within a specified GitHub organization, with options for detailed configuration including visibility, features, merge strategies, initial commit, and templates.
Create an organization variable
Creates a new, uniquely named GitHub Actions variable for an organization, with configurable repository access visibility (all, private, or selected).
Create an organization webhook
Creates a webhook for a GitHub organization to deliver event notifications to a configured URL.
Create a project card
Creates a project card in a GitHub project column (classic projects only). DEPRECATION NOTICE: GitHub Projects (classic) was sunset on August 23, 2024. This API only works with existing classic project columns. New classic projects cannot be created. Consider using GitHub Projects V2 (GraphQL API) instead. The request body must contain either: - `note`: A text note for the card - OR `content_id` AND `content_type`: To associate an issue or pull request
Create a project column (Classic - Deprecated)
Creates a new column in a GitHub project (classic). DEPRECATION NOTICE: GitHub Classic Projects (V1) and its REST API were sunset on April 1, 2025. 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/
Create a pull request
Creates a pull request in a GitHub repository, requiring existing `base` and `head` branches; `title` or `issue` must be provided.
Create a reference
Creates a 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.
Create a registration token for an organization
Generates a temporary (one-hour) registration token to add a new self-hosted runner to an organization for GitHub Actions.
Create a registration token for a repository
Generates a time-limited token required to register a new self-hosted runner with a specific repository.
Create a release
Creates a release in a GitHub repository for a specified tag; the tag must be unique for published releases, and if a `discussion_category_name` is given, it must already exist.
Create a remove token for an organization
Generates a token, valid for one hour, to authenticate removing a self-hosted runner from an organization.
Create a remove token for a repository
Generates a temporary (one-hour validity) token required to unregister and remove a self-hosted runner from a repository.
Create a reply for a review comment
Posts a reply to a specific review comment on a GitHub pull request, requiring the repository, pull request, and original comment to exist, and a non-empty reply body.
Create a repository dispatch event
Triggers a GitHub Actions workflow or a webhook on a repository by creating a repository dispatch event, allowing programmatic triggering of workflows based on events outside of GitHub.
Create a repository for the authenticated user
Creates a new repository for the authenticated user, optionally within an organization if `team_id` is specified.
Create a repository from an unpublished codespace
Publishes the specified codespace to a new repository, using the codespace's current state as the initial commit.
Create a repository project
Creates a new GitHub Projects V2 project board linked to a specified repository. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects V1 REST API has been sunset by GitHub. The project is owned by the repository owner (user or organization) and linked to the specified repository.
Create a repository ruleset
Creates a uniquely named ruleset for a repository, defining rules for branches or tags with specified enforcement, conditions, and bypass actors.
Create a repository using a template
Creates a new repository from an existing template repository; the authenticated user must have access to the template and, if creating in an organization, repository creation permissions within it.
Create a repository variable
Creates a new, unencrypted variable in a repository for GitHub Actions workflows; fails if a variable with the same name already exists.
Create a repository webhook
Creates a webhook for a specified repository; requires admin permissions on the repository.
Create a review comment for a pull request
Creates a review comment on a pull request's diff, targeting a specific line, range of lines, an entire file, or replying to an existing comment.
Create a review for a pull request
Creates a pull request review, allowing approval, change requests, or comments; `body` is required if `event` is `REQUEST_CHANGES` or `COMMENT`, and omitting `event` makes the review `PENDING`.
Create a scoped access token
Exchanges a user-to-server token for a new, fine-grained scoped access token for a GitHub App, requiring `client_id`, `access_token`, either `target` or `target_id`, and at least one permission; for repository-specific scoping, provide either `repositories` (names) or `repository_ids` (IDs), but not both.
Create a dependency snapshot
Creates a snapshot of a repository's dependencies to populate the GitHub dependency graph and enable security alerts; `sha` must be a 40-character commit ID, `ref` a fully qualified Git reference (e.g., `refs/heads/main`), and `scanned` an ISO 8601 timestamp.
Create a tag object
Creates an annotated Git tag object in a repository, pointing to an existing Git object (commit, tree, or blob) defined by its SHA and ensuring the `type` field correctly specifies the object's type.
Create a tag protection state for a repository
DEPRECATED: This API was sunset on August 30, 2024. Use GITHUB_CREATE_A_REPOSITORY_RULESET instead to create tag protection rules via repository rulesets.
Create a team
Creates a new team in an organization, optionally with maintainers, repositories, specific privacy, notification settings, or a parent team; if `parent_team_id` is given, `privacy` must be 'closed'.
Create a temporary private fork
Creates a temporary private fork of the specified repository to address a security vulnerability, linking the fork to a GHSA ID that must be specifically associated with this repository; the fork may take up to 5 minutes to become accessible.
Create a tree
Creates a new Git tree object in a repository, defining file/directory structure by specifying tree entries, optionally building on a `base_tree` SHA; all provided SHAs must be valid.
Create a user project
Creates a new GitHub Projects V2 project board for the authenticated user to organize and track issues, pull requests, and notes. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects V1 REST API has been sunset by GitHub.
Create a workflow dispatch event
Manually triggers a GitHub Actions workflow identified by `workflow_id` at a given `ref`, if the workflow is configured to accept `workflow_dispatch` events.
Create commit signature protection
Enables commit signature protection for a specified branch, requiring all new commits to be signed.
Create a custom deployment protection rule on an environment
Enables a custom deployment protection rule for an existing environment in a repository by linking a configured GitHub App (via `integration_id`) to control deployments.
Create draft item for user project
Creates a draft issue item in a user-owned GitHub ProjectsV2. Use when you need to add a new draft item to track ideas or tasks in a user's project.
Create inference chat completions
Tool to create chat completions using GitHub Models inference API. Use when you need to generate AI-powered text responses using models like GPT-4, Claude, or Llama through GitHub's inference endpoint.
Create inference embeddings
Tool to create inference embeddings using GitHub's AI models. Use when you need to convert text into vector representations for similarity search, clustering, or other ML tasks.
Create issue type
Create a new issue type for a GitHub organization. Requires the authenticated user to be an organization administrator. OAuth tokens need admin:org scope.
Create JIT runner config for repo
Generates a temporary Just-In-Time (JIT) configuration for a new self-hosted GitHub Actions runner for a repository; any specified non-default `runner_group_id` must be an existing runner group accessible by the repository.
Create or update an environment
Creates a new environment or updates an existing one in a GitHub repository, allowing configuration of deployment protection rules such as wait timers and reviewers; ensure `environment_name` is URL-encoded if it contains special characters.
Create or update an environment secret
Creates or updates an environment secret with an `encrypted_value` that was encrypted using the public key identified by `key_id` for the specified environment.
Create or update an organization secret
Creates or updates an organization secret for GitHub Actions, requiring its value to be pre-encrypted via LibSodium using the organization's public key.
Create or update a repository secret
Creates or updates a GitHub Actions secret within a specific repository; use `encrypted_value` and `key_id` to set or change its value.
Create or update a secret for the authenticated user
Creates or updates a Codespaces secret for the authenticated user; `encrypted_value` must be encrypted with the public key (ID: `key_id`) from GitHub's 'Get public key for the authenticated user' endpoint.
Create or update custom properties for an organization
Creates new custom property schemas or updates existing ones in bulk for a specified organization; each property definition must include `property_name` and `value_type`.
Create or update a custom property for an organization
Creates a new custom property (name must be unique for creation) or updates an existing one for an organization to define metadata for its repositories.
Create or update file contents
Creates a new file or updates an existing file in a GitHub repository; SHA can be provided to validate file updates, automatically fetched if not provided.
Create or Update GitHub Pages Site
Tool to enable or update GitHub Pages configuration for a repository. Use when setting up GitHub Pages for static site deployment or modifying Pages settings like custom domains and HTTPS enforcement.
Create or update repo secret with encrypted value
Creates or updates a Dependabot secret in a repository using an `encrypted_value` (pre-encrypted with LibSodium using the repository's Dependabot public key) and its corresponding `key_id`. 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.
Create reaction for a commit comment
Creates an emoji reaction for a commit comment; if the user has already reacted with the same content, details of the existing reaction are returned.
Create reaction for an issue
Creates a reaction for a specified issue within a GitHub repository.
Create reaction for an issue comment
Creates a reaction for a specific comment on an issue within a GitHub repository.
Create reaction for a pull request review comment
Adds a specified reaction to a pull request review comment within a GitHub repository.
Create reaction for a release
Creates an emoji reaction for a specific, existing release in a GitHub repository.
Create reaction for a team discussion
Creates a reaction for a team discussion within a GitHub organization.
Create reaction for a team discussion comment
Adds a reaction to a team discussion comment, requiring the specified organization, team, discussion, and comment to exist.
Create sponsorship
Tool to start a new GitHub sponsorship or reactivate a past sponsorship using GraphQL. Use when you need to sponsor a maintainer through GitHub Sponsors with a specified amount and privacy level.
Create Sponsors Tier
Tool to create a new payment tier for your GitHub Sponsors profile using GraphQL. Use when you need to add a new sponsorship tier with a specific monthly price and description. The amount is specified in dollars and will be converted to cents automatically.
Create or Update Organization Secret with LibSodium
Creates or updates a Dependabot organization secret, requiring the secret value to be pre-encrypted with LibSodium using the organization's public key obtained from the 'Get an organization public key' endpoint.
Create user list
Tool to create a new user list on GitHub. Use when you need to organize and group GitHub users for easier tracking and management.
Create view for user project
Tool to create a new view in a user-owned GitHub project (Projects V2). 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.
Decline a repository invitation
Declines a specific, pending repository invitation for the authenticated user, identified by its `invitation_id`.
Delete access restrictions
Removes all user, team, and app-based access restrictions from a protected branch.
Delete admin branch protection
Removes admin enforcement from a protected branch (branch name cannot contain wildcard characters) in a repository.
Delete a file
Deletes a file by path from a GitHub repository. The file's blob SHA is automatically fetched if not provided.
Delete a package version for the authenticated user
Deletes an existing package version associated with the authenticated user.
Delete an app authorization
Deletes an OAuth application grant for a user, which revokes ALL OAuth tokens and their associated authorizations for the application. This endpoint is only accessible to OAuth App owners and requires Basic Authentication using the OAuth App's client_id and client_secret.
Delete an app token
Revokes a single OAuth access token for an OAuth App or GitHub App with OAuth authorization. IMPORTANT: This endpoint requires Basic Authentication using the OAuth App's client_id as username and client_secret as password. It CANNOT be called with personal access tokens, GitHub App installation tokens, or any other token type. You must be the OAuth App owner to use this endpoint.
Delete a reference
Deletes a Git reference from a repository; 'ref' must be fully qualified (e.g., 'refs/heads/branch' or 'refs/tags/tag').
Delete a release
Permanently deletes a specific release, its assets, and potentially its associated Git tag from a repository.
Delete a release asset
Deletes a specific release asset from a GitHub repository; this action is idempotent.
Delete a release reaction
Deletes a reaction from a GitHub release, provided the repository, release, and reaction exist.
Delete a repository
Permanently deletes the specified repository; this is a destructive, irreversible action that requires admin privileges for the repository.
Delete a repository invitation
Deletes an active repository invitation, permanently revoking a user's access to collaborate on the specified repository.
Delete a repository ruleset
Permanently deletes a repository ruleset.
Delete a repository secret
Deletes a named GitHub Actions secret from a specified repository; this operation is destructive and idempotent, and requires the repository to exist.
Delete a repository subscription
Deletes the authenticated user's subscription to a specified repository if it exists, effectively 'unwatching' it.
Delete a repository variable
Deletes a named variable (e.g., for GitHub Actions workflows) from a repository; the repository and the variable must already exist.
Delete a repository webhook
Deletes a specific webhook from a repository.
Delete a review comment for a pull request
Deletes a specific pull request review comment.
Delete an artifact
Deletes a GitHub artifact by its ID within a repository, typically resulting in an empty response (HTTP 204 No Content) on success.
Delete a secret for the authenticated user
Deletes an existing Codespaces secret for the authenticated user by `secret_name`. This is a destructive and irreversible operation. Returns 404 if the secret does not exist.
Delete a self hosted runner from an organization
Forces the removal of a self-hosted runner from a GitHub organization. This endpoint can be used to completely remove the runner when the machine you were using no longer exists. The runner will be immediately disconnected from GitHub Actions. Requires admin:org scope and organization admin access. Returns 204 No Content on successful deletion.
Delete a self hosted runner from a repository
Removes a specific self-hosted runner (by `runner_id`) from a repository, if registered there; this is idempotent.
Delete a tag protection state for a repository
DEPRECATED: This API was sunset on August 30, 2024. Use GITHUB_DELETE_A_REPOSITORY_RULESET instead to manage tag protection rules via repository rulesets.
Delete a team
Deletes a team (and any child teams) from an organization.
Delete a thread subscription
Call this to mute a specific notification thread by deleting the user's subscription; notifications may still occur if the user is @mentioned, comments, or due to repository watch settings.
Delete an autolink reference from a repository
Deletes a specific autolink reference (which automatically links external resource IDs like JIRA-123 to URLs) from the specified repository.
Delete a workflow run
Deletes a specific workflow run from a repository.
Delete branch protection
Removes all protection rules from a specific branch in a GitHub repository; the branch must currently have protection rules enabled.
Delete a code scanning analysis from a repository
Deletes a specific code scanning analysis by its ID from a repository; `confirm_delete` must be `true` if it's the last analysis of its type for a given tool and reference to prevent data loss.
Delete a codespace for the authenticated user
Deletes a specific codespace owned by the authenticated user; this is a destructive action and the codespace must exist.
Delete a commit comment
Deletes a specific commit comment, identified by its `comment_id`, from the specified repository; the comment must exist.
Delete a commit comment reaction
Deletes a reaction from a commit comment in a GitHub repository.
Delete commit signature protection
Disables GPG commit signature protection for a specific branch in a GitHub repository, meaning commits pushed to this branch no longer require GPG signing.
Delete a custom organization role
Deletes a custom organization role (which should not be actively assigned) by its ID; a 204 No Content response indicates success.
Delete dependabot secret by name
Deletes a specific Dependabot secret, identified by its name, from a given repository if both the repository and secret exist.
Delete a deploy key
Deletes a specific deploy key from a repository; to change a key's properties or access scope, the existing key must be deleted and a new one created.
Delete a deployment
Permanently deletes a specified *inactive* deployment from a repository.
Delete a deployment branch policy
Deletes a specific deployment branch or tag policy, identified by its ID, from a given environment within a repository.
Delete a discussion
Deletes a specific team discussion, identified by its number, from an organization's team.
Delete a discussion comment
Deletes a specific comment from an existing team discussion within an organization, provided the specified organization, team, discussion, and comment all exist.
Delete authenticated user email address
Sends an empty request body to `DELETE /user/emails` to attempt deletion of user email addresses; the API typically requires specific emails, so outcome may vary.
Delete an environment
Deletes an existing deployment environment from an existing repository.
Delete an environment secret
Deletes an existing and accessible secret from a specified environment within a GitHub repository, returning an empty dictionary on success or error details otherwise.
Delete an environment variable
Deletes a named environment variable from a specified, existing environment within a GitHub repository.
Delete a gist
Permanently deletes an existing GitHub gist, specified by its `gist_id`; this action is destructive and cannot be undone.
Delete a gist comment
Deletes a specific comment from a GitHub Gist using its `gist_id` and `comment_id`.
Delete GitHub Actions cache by ID
Deletes a specific GitHub Actions cache from a repository using its unique `cache_id`.
Delete a GitHub Pages site
Deletes the GitHub Pages site for the specified repository; completes without error if no site is currently enabled.
Delete an issue comment
Permanently deletes a specific comment by its ID from an issue or pull request, if the repository exists and the comment ID is valid.
Delete an issue comment reaction
Deletes a reaction from an issue comment in a repository; the repository, comment, and reaction must exist.
Delete an issue reaction
Permanently removes a specific reaction from an issue in a GitHub repository.
Delete a label
Permanently removes an existing label from a repository.
Delete a milestone
Deletes the specified milestone if it exists; this operation is idempotent, typically returning a 404 if the milestone is not found or already deleted.
Delete an organization
Deletes a GitHub organization and its repositories; this is a destructive action and the organization name will be unavailable for reuse for approximately 90 days.
Delete an organization secret
Permanently deletes a secret from a GitHub organization, making it inaccessible to GitHub Actions workflows or other tools.
Delete an organization variable
Deletes a named GitHub Actions variable from a specified organization.
Delete an organization webhook
Deletes a specific webhook, identified by `hook_id`, from an existing organization.
Delete a codespace from the organization
Permanently deletes a specific codespace belonging to a member of the specified organization.
Delete a package for an organization
Deletes a specific package in an organization; cannot delete public packages with over 5,000 downloads.
Delete a package for the authenticated user
Permanently deletes a specific package owned by the authenticated user; public packages downloaded over 5,000 times cannot be deleted via this API.
Delete package version
Tool to delete a package version using GitHub GraphQL API. Use when you need to remove a specific version of a package by its global node ID.
Delete package version for an organization
Deletes a specific package version within an organization; requires admin permissions for packages with over 5,000 downloads.
Delete package version for a user
Permanently and irreversibly deletes a specific version of a package owned by the specified user.
Delete a pending review for a pull request
Deletes a pending (unsubmitted) review from a pull request; this is only possible if the review has not yet been submitted.
Delete a project
Deletes the 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.
Delete a project card (Classic - Deprecated)
Deletes 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/
Delete a project field (column)
Deletes a project field (column) from a GitHub Projects V2 project using the GraphQL API. IMPORTANT: GitHub Classic Projects REST API was sunset on April 1, 2025. This action now uses the GitHub Projects V2 GraphQL API with the deleteProjectV2Field mutation. Note: The built-in Status field cannot be deleted as it is a core field in GitHub Projects V2. Only custom fields can be deleted.
Delete project item for user
Tool to delete a project item for a user in GitHub Projects V2. Use when you need to remove an item from a user's project. Requires the project item's GraphQL node ID (starts with 'PVTI_'). Uses the GitHub GraphQL API deleteProjectV2Item mutation.
Delete a pull request comment reaction
Deletes a specific reaction from a pull request review comment, provided the comment and reaction exist on that comment within the specified repository.
Delete pull request review protection
Disables the requirement for pull request reviews before merging for a specific, existing branch in an existing repository; this action is idempotent and will succeed even if the protection is not currently enabled.
Delete repo codespace secret by name
Deletes a specific Codespace secret from a repository by its name; this action is idempotent and will succeed even if the secret doesn't exist.
Delete social accounts for the authenticated user
Deletes currently linked social media account URLs from the authenticated user's GitHub profile.
Delete team discussion comment reaction
Deletes a reaction from a team discussion comment, given the organization name, team slug, discussion number, comment number, and reaction ID.
Delete team discussion reaction
Permanently deletes a specific reaction from a team discussion within an organization.
Delete User List
Tool to delete a GitHub user list using GraphQL. Use when you need to remove a user list from a GitHub account.
Delete a package for a user
Deletes a package owned by the specified user, requiring admin permissions for the authenticated user; deletion of public packages with over 5,000 downloads may require GitHub support.
Delete workflow run logs
Deletes all logs for a specific workflow run in a GitHub repository, provided the repository and run exist.
Disable a custom protection rule for an environment
Disables a specific, currently active custom deployment protection rule for an existing environment within a GitHub repository.
Disable a workflow
Disables a specified workflow (by ID or filename) in a given GitHub repository, preventing new automatic triggers; any in-progress runs will continue.
Disable private vulnerability reporting for a repository
Disables private vulnerability reporting for an existing GitHub repository, preventing direct private vulnerability reports to maintainers via GitHub's interface for this repository.
Disable Repository Actions In Org
Removes a repository from the list of selected repositories enabled for GitHub Actions in an organization. Only works when the organization's `enabled_repositories` policy is set to `selected`. Requires admin:org scope.
Dismiss a review for a pull request
Dismisses an APPROVED or CHANGES_REQUESTED review on a pull request with a mandatory explanatory message. IMPORTANT: Only reviews in APPROVED or CHANGES_REQUESTED state can be dismissed. Reviews in COMMENTED, PENDING, or already DISMISSED state will return a 422 error. To dismiss a review on a protected branch, you must be a repository admin or be authorized to dismiss pull request reviews.
Download an artifact
Downloads a GitHub Actions workflow artifact as a ZIP file. Returns the artifact as a downloadable file. Use GITHUB_LIST_ARTIFACTS_FOR_A_REPOSITORY or GITHUB_LIST_WORKFLOW_RUN_ARTIFACTS to get valid artifact IDs first.
Download a repository tarball
Downloads a repository's source code as a tarball (.tar.gz) archive for a specific Git reference, if the repository is accessible.
Download a repository archive ZIP
Downloads a repository's source code as a ZIP archive for a specific Git reference (branch, tag, or commit SHA). IMPORTANT SIZE LIMITATION: This action may fail with 'payload too large' errors for large repositories due to platform size restrictions. If you encounter size limit issues, consider these alternatives: - Use GITHUB_GET_REPOSITORY_CONTENT to fetch specific files or directories (also lists directory contents) - Clone the repository using git if you need the full codebase Best suited for: small to medium repositories, downloading specific tagged releases, or quick code inspection.
Download job logs for a workflow run
Downloads logs for a specific job in a GitHub Actions workflow run, contingent on the repository's existence and the job ID being valid and having produced logs.
Download workflow run attempt logs
Downloads a ZIP archive of logs for a specific workflow run attempt. Returns a downloadable ZIP file containing logs for all jobs and steps in the workflow run.
Download workflow run logs
Downloads logs for a specific GitHub Actions workflow run as a ZIP archive containing log files for each job in the workflow.
Enable a workflow
Reactivates a currently disabled GitHub Actions workflow within a repository using its workflow ID or filename.
Enable GitHub actions in selected repositories
Sets the specific repositories that can use GitHub Actions within an organization by replacing the current list; only applies if the organization's Actions policy is 'selected repositories'.
Enable private vulnerability reporting for a repository
Enables private vulnerability reporting for a repository, allowing security researchers to privately submit vulnerability reports to maintainers.
Enable repo for Github Actions
Adds a repository to the list of selected repositories enabled for GitHub Actions in an organization. Requires the organization's 'enabled_repositories' policy to be set to 'selected'.
Encrypt and update dev secret
Creates or updates a repository's development environment secret using an `encrypted_value` and its corresponding `key_id`; the secret must be pre-encrypted with the repository's Codespaces public key.
Encrypt org dev env secret
Creates or updates an organization's GitHub Codespaces secret using an encrypted value and its corresponding public key ID.
Export a codespace for the authenticated user
Triggers an export of a user's specified codespace, automatically stopping it if active, and returns its export status and download URL.
Export an SBOM for a repository
Exports the software bill of materials (SBOM) in SPDX JSON format for a repository, if its dependency graph is enabled and it has at least one commit.
Find Pull Requests
Primary tool to find and search pull requests. Supports filtering by repository, author, state, labels, and merge status, and returns structured PR data for reliable use in workflows. GitHub search results are capped at ~1000 total items; narrow filters when totals approach this limit. `created_since`/`updated_since` filter on creation/update timestamps, not `merged_at`; apply merge-date filtering client-side.
Find Repositories
AI-optimized repository search with smart filtering by language, stars, topics, and ownership. Builds intelligent search queries and returns clean, actionable repository data. Check `incomplete_results` in the response — when true, results are non-exhaustive. Search endpoints are rate-limited to ~30 requests/minute (vs. 5000/hour for general REST); apply backoff on 403/429. Total results are capped at ~1000 per query regardless of pagination.
Follow Organization (GraphQL)
Tool to follow a GitHub organization using GraphQL. Use when you need to make the authenticated user follow an organization.
Follow a user
Allows the authenticated user to follow the GitHub user specified by `username`; this action is idempotent and the user cannot follow themselves.
Follow User (GraphQL)
Tool to follow a GitHub user using GraphQL. Use when you need to make the authenticated user follow another user.
Force cancel a workflow run
Forcefully cancels a queued or in-progress GitHub Actions workflow run, bypassing conditions like always() that would otherwise continue execution. Only use when the standard cancel endpoint fails. Cannot cancel completed workflow runs. Requires write permissions to the repository.
Fork a gist
Forks a specified public gist, creating a copy under the authenticated user's account.
Generate release notes content for a release
Generates Markdown release notes content (listing changes, pull requests, and contributors) for a GitHub repository release, customizable via tags and a configuration file.
Get a blob
Retrieves the raw, typically Base64-encoded, content of a file (blob) from a GitHub repository using its SHA hash, if the repository and blob SHA exist.
Get a branch
Retrieves detailed information for a specified branch within a GitHub repository.
Get access restrictions
Lists users, teams, and GitHub Apps with push access to a branch; this branch must be protected in repository settings for detailed restrictions, otherwise expect a 404 or empty response.
Get a commit
Retrieves a specific commit from a repository by its owner, name, and a valid commit reference (SHA, branch, or tag), supporting pagination for large diffs.
Get admin branch protection
Checks if repository administrators are subject to the branch protection rules on a specific branch.
Get all API versions
Retrieves all officially supported, date-based (e.g., "2022-11-28") versions of the GitHub REST API from the /versions endpoint.
Get all contributor commit activity
Retrieves commit activity (total commits, weekly additions/deletions/commits) for all contributors to a repository; may require a retry if GitHub returns 202 while preparing data.
Get all deployment protection rules for an environment
Lists all enabled custom deployment protection rules for a specific environment in a repository; the environment must exist and be configured for deployments.
Get a milestone
Retrieves detailed information for a specific milestone within a GitHub repository by its number.
Get an app
Retrieves publicly available information for an existing GitHub App, identified by its unique URL-friendly `app_slug`.
Get an artifact
Gets a specific artifact for a repository by `artifact_id`. 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.
Get an assignment
Retrieves detailed information for a specific GitHub Classroom assignment if the authenticated user is an administrator of the classroom.
Get an autolink reference of a repository
Retrieves a specific autolink reference (which automatically hyperlinks text like 'JIRA-123' to an external system) for a repository using its unique ID; requires administrator access to the repository.
Get an environment
Retrieves the details of a specific deployment environment for a given repository, including its name, configurations, and current status.
Get an environment public key
Retrieves the public key for a specified GitHub repository environment, used to encrypt secrets for GitHub Actions.
Get an environment secret
Retrieves metadata (name and timestamps) for a single secret in a GitHub Actions environment. Note: The actual secret value is never returned by this API for security reasons.
Get an environment variable
Retrieves a specific environment variable from a GitHub Actions environment by repository owner, repository name, environment name, and variable name.
Get an issue
Retrieves detailed information about a specific issue in a repository using the owner, repository name, and issue number.
Get an issue comment
Action to get an issue comment.
Get an issue event
Fetches details of a specific issue event for a given repository and event ID.
Get an organization
Get an organization
Get an organization public key
Action for `GetAnOrganizationPublicKey`.
Get an organization role
Retrieves a specific GitHub organization role by its ID.
Get an organization secret
Gets an organization secret's metadata (e.g., name, creation/update dates, visibility), but not its encrypted value.
Get an organization variable
Retrieves details (name, value, visibility, timestamps) of a specific, existing variable for an existing GitHub organization.
Get an organization webhook
Retrieves the full configuration, including subscribed events and delivery settings, for an existing organization webhook.
Get a package for an organization
Retrieves a specific package (by type and name) from an organization, if both the package and organization exist.
Get a package for a user
Retrieves metadata for a specific package owned by a GitHub user, using package type, name, and username as identifiers.
Get a package for the authenticated user
Retrieves detailed information for a specific package owned by the authenticated user.
Get a package version for an organization
Retrieves detailed information for a specific version of a package within an organization.
Get a package version for a user
Retrieves a specific public package version associated with a GitHub user.
Get authenticated user package version
Retrieves detailed information for an existing specific package version associated with the authenticated user, identified by its type, name, and version ID.
Get a project
Retrieves detailed information for a specific GitHub project (V2) using its project number and owner. Note: This action uses GitHub's Projects V2 REST API. The legacy Projects (classic) REST API was sunset on April 1, 2025. The project is identified by its number (visible in the project URL) and owner (either a username or organization name). If no owner is specified, the authenticated user is assumed.
Get a project card
Retrieves all details of a specific project card, given its unique `card_id`. DEPRECATION NOTICE: GitHub Projects (classic) REST API was sunset on April 1, 2025. This action only works with existing classic project cards that were created before the sunset date. For new projects, use GitHub Projects V2 (GraphQL API) instead.
Get a project column (Classic - Deprecated)
Retrieves 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.
Get a pull request
Retrieves a specific pull request from a GitHub repository using its owner, repository name, and pull request number.
Get a reference
Retrieves a specific Git reference (e.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.
Get a release
Gets a specific release from a GitHub repository, provided the repository is accessible and the release exists.
Get a release asset
Gets metadata for a specific release asset in a GitHub repository, including a `browser_download_url` for downloading the asset.
Get a release by tag name
Gets a release from a GitHub repository by its tag name; the repository and a release with this tag must already exist.
Get a repository
Retrieves detailed information about an existing and accessible GitHub repository.
Get a repository public key
Gets a repository's public key for encrypting secrets to be used in GitHub Actions, if the repository exists and is accessible.
Get a repository readme
Fetches the README file (if it exists and is accessible) from a specified GitHub repository, returning its Base64-encoded content and metadata.
Get a repository readme for a directory
Retrieves the README file from a specified directory within a GitHub repository, optionally at a given commit, branch, or tag.
Get a repository ruleset
Retrieves a specific repository ruleset by its ID; if `includes_parents` is true, the search for this `ruleset_id` also extends to rulesets from parent organizations.
Get a repository rule suite
Gets detailed information for a specific repository rule suite by its ID, including its evaluation status and the results of its individual rules.
Get a repository secret
Gets metadata (name, creation/update timestamps) for an existing repository secret, excluding its encrypted value.
Get a repository subscription
Gets the authenticated user's subscription details for a repository, indicating if they receive notifications.
Get a repository variable
Gets a specific GitHub Actions variable by name from an accessible repository.
Get a repository webhook
Returns the configuration of an existing webhook for a given repository.
Get a review comment for a pull request
Retrieves a specific pull request review comment by its ID, provided the repository exists, is accessible, and the comment ID is valid.
Get a review for a pull request
Retrieves a specific review for a pull request using its owner, repository, pull request number, and review ID.
Get a secret for the authenticated user
Retrieves metadata (name, timestamps, visibility; not the value) for a specific, existing development environment secret associated with the authenticated user's GitHub Codespaces.
Get a self hosted runner for an organization
Retrieves detailed information about a specific self-hosted runner registered within a GitHub organization.
Get a self hosted runner for a repository
Gets a specific self-hosted runner for a repository by its unique ID.
Get assignment grades
Retrieves all grades for an existing GitHub Classroom assignment.
Get a tag
Retrieves detailed information for a specific Git tag object from a GitHub repository, using the SHA of the tag object itself.
Get a team by name
Retrieves a GitHub team by its slug from a specific organization.
Get a thread
Retrieves a specific GitHub notification thread using its unique `thread_id`.
Get a thread subscription for the authenticated user
Retrieves the authenticated user's subscription details for a specific notification thread, identified by `thread_id`.
List repository files and directories
Browse and list all files/directories in a GitHub repository. Efficiently retrieves the complete repository structure in a single API call when used with recursive mode. Perfect for analyzing codebase structure, finding specific files, or getting an overview of repository contents without cloning.
Get a user
Retrieves the public profile information for an existing GitHub user, specified by their username.
Get a webhook configuration for an organization
Retrieves the configuration for a specific webhook associated with a GitHub organization.
Get a webhook configuration for a repository
Returns the configuration for an existing webhook on the specified repository.
Get a webhook delivery for an organization webhook
Returns detailed information for a specific delivery attempt of a webhook configured for the specified GitHub organization.
Get a workflow
Retrieves detailed information for a specific GitHub Actions workflow in a repository, identified by either its numeric ID or its filename.
Get a workflow run
Gets a specific workflow run by its ID from a GitHub repository.
Get a workflow run attempt
Retrieves detailed information for a specific attempt of a workflow run in a GitHub repository, including its status, conclusion, and timings.
Get billing usage report for user
Retrieves the billing usage report for a specified GitHub user. Use when you need to analyze billing costs and usage patterns.
Get branch protection
Retrieves branch protection settings for a specific, existing, and accessible branch in a GitHub repository; protection feature availability varies by GitHub product plan.
Get catalog models
Tool to retrieve the list of AI models available in the GitHub Models catalog. Use when you need to discover available models, their capabilities, token limits, and supported modalities.
Get a check run
Retrieves detailed information for a specific check run within a GitHub repository.
Get a check suite
Retrieves a specific check suite (a collection of check runs) by its ID from a repository accessible to the authenticated user.
Get a classroom
Retrieves details for a specific GitHub Classroom. Requires the authenticated user to be an administrator of the classroom.
Get a code of conduct
Retrieves the full details of a specific GitHub code of conduct using its unique key.
Get Code of Conduct (GraphQL)
Tool to look up a code of conduct by its key using GitHub's GraphQL API. Use when you need to fetch code of conduct details as part of a GraphQL workflow.
Get a CodeQL database for a repository
Gets an existing CodeQL database (including a download URL) for a specified language in an accessible repository, if one has been successfully built for that language.
Get a code scanning alert
Retrieves a specific code scanning alert, which identifies potential code vulnerabilities or errors, by its number from the specified GitHub repository.
Get a code scanning analysis for a repository
Retrieves detailed information for a specific code scanning analysis on an accessible repository, identified by its `analysis_id`.
Get a code scanning default setup configuration
Gets the default setup configuration for code scanning in a repository, including state, languages, query suite, and schedule for a repository if it exists.
Get a codespace for the authenticated user
Call to retrieve detailed information for a `codespace_name` belonging to the authenticated user, ensuring the codespace exists and is accessible.
Get commit authors
Fetches commit authors identified during a repository import, used to map authors from an external VCS to GitHub accounts. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports.
Get a commit comment
Retrieves the full details of a specific commit comment in a GitHub repository, using its unique identifier.
Get a commit object
Retrieves detailed information (including author, committer, message, tree, parents, verification) for a specific commit in a GitHub repository, identified by its SHA.
Get commit signature protection
Gets the commit signature protection status for a branch in a repository.
Get commit statuses
List all statuses for a commit reference (SHA, branch, or tag) in reverse chronological order. Use when you need to check CI/CD status results from various systems for a specific commit.
Get community profile metrics
Retrieves a repository's community profile metrics, including health percentage and the presence of key community files (e.g., README, LICENSE).
Get contextual information for a user
Gets contextual hovercard information for a GitHub user; `subject_type` and `subject_id` can be jointly provided for more specific details.
Get a custom deployment protection rule
Retrieves a specific custom deployment protection rule (used by GitHub Apps for external validation or manual approval of deployments) for a given environment in a repository.
Get default attributes for a codespace
Get pre-flight data (e.g., default location, devcontainer path) for creating a Codespace in a given repository (must exist and be accessible), optionally for a specific Git ref.
Get default workflow permissions for an organization
Gets the default GITHUB_TOKEN workflow permissions and settings for a GitHub organization.
Get default workflow permissions for a repository
Gets the default workflow permissions (`read` or `write`) for the GITHUB_TOKEN and whether it can approve pull request reviews in an existing and accessible repository.
Get a diff of the dependencies between commits
Gets the dependency diff between two Git revisions in a repository, where 'basehead' specifies the revisions and 'name' can optionally scope to a specific manifest file.
Get a deploy key
Gets a specific deploy key, identified by its `key_id`, for the GitHub repository specified by `owner` and `repo`.
Get a deployment
Gets a specific deployment by ID from a repository, provided the repository and deployment ID exist.
Get a deployment branch policy
Retrieves a specific deployment branch policy for an environment in a repository, identified by its unique ID.
Get a deployment status
Retrieves a specific deployment status by its ID for a given deployment within a GitHub repository.
Get details about a codespace export
Retrieves detailed information about a specific export of a codespace.
Get a discussion
Fetches a specific discussion by its number from a team within an organization. This is a read-only action that retrieves discussion details including title, body, author information, comment count, and reactions. The authenticated user must be a member of the organization to access team discussions.
Get a discussion comment
Fetches a specific comment from a team discussion within a specific organization.
Get emojis
Lists all emojis available for use on GitHub, including custom and Unicode emojis.
Get Enterprise Member Invitation
Tool to look up a pending enterprise unaffiliated member invitation by invitee and enterprise. Use when you need to check the status of a specific invitation.
Get feeds
Fetches a list of available GitHub feed URLs for the authenticated user.
Get a gist
Fetches a specific GitHub gist by its `gist_id`, returning comprehensive details if the gist exists.
Get a gist comment
Retrieves a specific Gist comment by its ID and the Gist's ID.
Get a gist revision
Retrieves a specific revision of a gist.
Get GitHub Actions cache usage for an organization
Retrieves total GitHub Actions cache usage statistics for an organization, including active cache count and size across all repositories.
Get github actions cache usage for a repository
Retrieves the total count of active GitHub Actions caches and their combined size in bytes for a specified repository.
Get github actions permissions for an organization
Gets the GitHub Actions permissions for a specified organization, detailing repository enablement and allowed actions policies.
Get GitHub Actions permissions for a repository
Gets the GitHub Actions permissions policy for a repository, including its enabled status and the scope of allowed actions.
Get billing premium request usage
Tool to get billing premium request usage report for a GitHub user. Use when you need to retrieve usage data for premium features like Copilot or AI models.
Get billing usage summary for user
Tool to retrieve billing usage summary for a GitHub user account. Use when tracking usage costs, monitoring billing details, or generating usage reports for a specific user. Note: This endpoint only returns data for the past 24 months and is currently in public preview.
Get github meta information
Fetches GitHub's publicly available metadata, useful for configuring network security policies or IP allow-listing.
Get github pages build
Retrieves detailed information about a specific GitHub Pages build for a repository, which must have GitHub Pages enabled.
Get a gitignore template
Retrieves a specific .gitignore template from GitHub by its name, which must be an existing template in GitHub's collection.
Get a global security advisory
Retrieve a global GitHub security advisory by its GHSA identifier. Use this to get detailed information about vulnerabilities including severity, affected packages, CVSS scores, and references.
Fetch GraphQL Node
Tool to fetch any GitHub object by its global node ID. Use when you have a node_id and need to retrieve the corresponding object details.
Get GraphQL rate limit
Tool to retrieve the authenticated client's GitHub GraphQL API rate limit information. Use when you need to check remaining quota, current usage, or reset time for GraphQL requests.
Get information about a sarif upload
Retrieves detailed information, including processing status and results URL, about a specific SARIF (Static Analysis Results Interchange Format) upload for a repository, uniquely identified by its sarif_id.
Get interaction restrictions for an organization
Retrieves interaction restrictions for an organization, showing which GitHub user types can interact with its public repositories and when restrictions expire; returns an empty response if no restrictions are set.
Get interaction restrictions for a repository
Retrieves active interaction restrictions for a repository, detailing which user groups are limited from activities like commenting or creating pull requests, and when these restrictions expire.
Get interaction restrictions for public repositories
Retrieves currently active interaction restrictions for the authenticated user's public repositories.
Get a label
Retrieves a specific label by its name from a specified GitHub repository.
Get large files
Lists files larger than 100MB identified during a previous source import for the specified repository. 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.
Get latest pages build
Retrieves information about the most recent GitHub Pages build for a repository, which must exist, be accessible, have GitHub Pages enabled, and have at least one prior build.
Get a license
Call this action to retrieve comprehensive details for a specific software license recognized by GitHub, using its unique license key.
Get License (GraphQL)
Tool to look up an open source license by its SPDX ID using GitHub's GraphQL API. Use when you need to fetch license details for compliance tracking or repository setup.
Get octocat
Fetches an ASCII art representation of GitHub's Octocat, suitable for text-based displays.
Customize OIDC subject claim template
Retrieves the OpenID Connect (OIDC) subject claim customization template for a repository, which defines the `sub` claim structure in OIDC tokens for GitHub Actions workflows; returns the default configuration if no customization is applied.
Get allowed actions and workflows for an org
Gets the list of allowed actions and reusable workflows for an organization when the 'allowed_actions' policy is set to 'selected'.
Get organization audit log
Tool to retrieve an organization's audit log events for security and compliance investigations. Use when tracking organizational changes, security audits, or compliance monitoring. Requires organization owner permissions and read:audit_log scope.
Get a custom property for an organization
Retrieves the definition (schema) of a specific, existing custom property for an organization.
Get organization project item
Tool to get an item from an organization-owned GitHub Projects V2 project. Use when you need to retrieve details about a specific project item including its content, fields, timestamps, and creator information.
Get organization public key for Codespaces secrets
Retrieves an organization's public key, which must be used to encrypt secret values before they are configured for Codespaces.
Fetch Public Key For Secret Encryption
Retrieves the public key for an existing GitHub organization, required for encrypting Dependabot secrets. Requires admin:org scope.
Get org dev environment secret safely
Retrieves metadata for a specific secret available to an organization's GitHub Codespaces without exposing its encrypted value.
Get custom OIDC subject claim template
Retrieves the OpenID Connect (OIDC) subject claim customization template for a GitHub organization, which defines how the `sub` claim in OIDC tokens for workflows is constructed.
Get a dns health check for github pages
Retrieves the DNS health check status (e.g., CNAME/A records, HTTPS) for a GitHub Pages site; the check may be pending (HTTP 202) on initial calls or after site changes.
Get a GitHub Pages site
Retrieves information for a GitHub Pages site, which must be enabled for the repository.
Get page views
Retrieves page view statistics for a repository over the last 14 days, including total views, unique visitors, and a daily or weekly breakdown.
Get pending deployments for a workflow run
Retrieves pending deployment environments for a specific workflow run that are awaiting approval due to protection rules.
Get project permission for a user
Retrieves permission information for a GitHub project (classic) collaborator. Returns the permission level and full user object for a collaborator on a GitHub project (classic). The permission returned can be admin, write, read, or none.
Get public key for secret encryption
Retrieves a repository's public key for encrypting GitHub Codespaces secrets; requires `repo` scope or equivalent read access to codespaces secrets for private repositories.
Get public key for the authenticated user
Retrieves the authenticated user's public key for encrypting GitHub Codespaces secrets. The returned key must be used with libsodium sealed box encryption before creating or updating secrets via the API.
Get pull request review protection
Retrieves the pull request review protection settings for a specific branch in a GitHub repository, if such protection is configured.
Get rate limit status for the authenticated user
Retrieves the authenticated user's current GitHub API rate limit status, including usage and limits across different resource categories.
Get Raw Repository Content
Tool to fetch raw file content from a GitHub repository. Returns raw bytes in whatever format the file uses (JSON, CSV, binary, etc.) — parsing and validation are the caller's responsibility. Ensure owner, repo, ref, and path are consistent when combining with other GitHub tools to avoid mismatched-ref errors.
Get allowed actions and workflows for a repository
Gets the settings for allowed actions and reusable workflows in a repository. Requires the repository's `allowed_actions` policy to be set to `selected` (returns 409 if set to `all` or `local_only`).
Get repository development environment secret
Gets metadata (name, creation/update timestamps) for a specific, existing development environment secret (Codespaces secret) in a repository, without exposing its value.
Get repository attestations
Tool to retrieve attestations by subject digest from a GitHub repository. Use when you need to verify or check attestations for a specific artifact identified by its SHA256 digest.
Get repository clones
Retrieves the total number of clones and a breakdown of clone activity (daily or weekly) for a specified repository over the preceding 14 days.
Get repository content
Retrieves a file's Base64 encoded content or lists a directory's contents from a GitHub repository.
Get Repository via GraphQL
Tool to lookup a repository by owner and name using GitHub's GraphQL API. Use when you need comprehensive repository information.
Get Repository Owner
Tool to lookup a repository owner (User or Organization) by login using GitHub's GraphQL API. Use when you need to determine whether a login is a user or organization and retrieve basic profile information.
Get repository permissions for a user
Retrieves a specific user's permission level ('admin', 'write', 'read', or 'none') for a given repository, where 'maintain' role is reported as 'write' and 'triage' as 'read'.
Retrieve repo public key for encryption
Gets a repository's public key, used to encrypt secrets for Dependabot.
Get repository secret securely
Retrieves metadata for an existing Dependabot secret in a repository, without exposing its encrypted value.
Get repository security advisory
Tool to retrieve a repository security advisory using its GHSA identifier. Use when you need detailed information about a specific security vulnerability.
Get a delivery for a repository webhook
Retrieves a specific delivery for a repository webhook, identified by its `hook_id` and `delivery_id`.
Get rules for a branch
Retrieves all active rules for a specific branch in a GitHub repository, excluding rules in 'evaluate' or 'disabled' status.
Get Organization Dependabot Secret
Gets a single organization Dependabot secret's metadata (name, timestamps, visibility) without revealing its encrypted value. Requires admin:org scope.
Get status checks protection
Retrieves the status check protection settings for a specific branch in a GitHub repository, if status check protection is enabled for it.
Get team membership for a user
Retrieves a user's role and membership status within a specific team in an organization. Returns membership details including role ('member' or 'maintainer') and state ('active' or 'pending'). If the user is not a member of the team, returns is_member=False with a descriptive message. Requires the authenticated user to be an organization member with visibility into the team.
Get teams with access to the protected branch
Lists teams with explicit push access to a protected branch, provided team restrictions are configured in the branch's protection settings; returns an empty list otherwise.
Get the authenticated user
Gets the profile information for the currently authenticated GitHub user, including potentially private details based on user settings.
Get the combined status for a specific reference
Retrieves the aggregated commit status (e.g., success, failure, pending) from all checks for a specific reference (SHA, branch, or tag) in a GitHub repository.
Get the hourly commit count for each day
Retrieves the 'punch card' data, showing hourly commit counts for each day of the week for an existing and accessible repository.
Get the last year of commit activity
Fetches weekly commit totals and daily commit counts for the last 52 weeks for a specified GitHub repository.
Get the latest release
Fetches the latest official (non-prerelease, non-draft) release for a GitHub repository; requires at least one such published release.
Get the license for a repository
Retrieves the license file and its details for a repository, optionally from a specific Git reference (branch, tag, or commit SHA).
Get the review history for a workflow run
Retrieves the detailed approval history for a specific workflow run in a GitHub repository, detailing each review's environment, state, reviewer, and comments, to track the approval process for workflows, particularly automated deployments.
Get the status of a GitHub Pages deployment
Retrieves the status of a specific GitHub Pages deployment for a repository, which must have GitHub Pages enabled.
Get the weekly commit activity
Fetches the weekly commit activity (additions and deletions per week) for a repository over the past year; best for repositories with under 10,000 commits.
Get the weekly commit count
Retrieves the weekly commit count for a repository, detailing commits by the owner and all contributors over the last 52 weeks; GitHub may return a 202 status or an empty response if statistics are being computed.
Get the Zen of GitHub
Retrieves a random quote from GitHub's 'Zen of GitHub' collection, reflecting GitHub's design philosophies and offering humorous insights, useful for displaying GitHub wisdom or a lighthearted message.
Get top referral paths
Fetches the top 10 most viewed content paths for a repository from the last 14 days.
Get top referral sources
Fetches the top 10 websites that referred traffic to a repository within the last 14 days.
Get user by ID
Retrieves a GitHub user's profile information by their unique numeric account ID. Use when you know the user's numeric ID rather than their username.
Get user project item
Tool to get an item from a user-owned project in GitHub Projects V2. Use when you need to retrieve details about a specific item (issue, pull request, or draft issue) in a user's project board.
Get user attestations by subject digest
Tool to get attestations by subject digest for a GitHub user. Use when you need to retrieve attestation data for a specific artifact or resource identified by its subject digest.
Get user's projects v2
Tool to list GitHub Projects v2 for a specified user. Use when you need to retrieve all projects owned by a user with pagination support.
Get users with access to the protected branch
Lists users with explicit push access to a protected branch, provided its protection rule restricts pushes to specific users.
Get Viewer via GraphQL
Tool to retrieve the authenticated user's profile information via GitHub GraphQL. Use when working with GraphQL queries or need viewer details in GraphQL format.
Get workflow external access level
Gets the access level settings for a private repository, determining how workflows outside this repository can use its actions and reusable workflows.
Get a job for a workflow run
Retrieves detailed information for a specific job within a GitHub Actions workflow run, given its `job_id` which must be valid for the specified repository's workflow.
Get workflow run usage
Gets the billable time, in milliseconds, for a specific workflow run, detailing time spent on various operating systems.
Get workflow usage
Gets the billable time (in milliseconds, broken down by runner OS) for a specific workflow within a repository for the current billing cycle.
Check if repo starred by auth user
Use to determine if the authenticated user has starred a specific GitHub repository, which is confirmed by an HTTP 204 status (resulting in an empty dictionary in the response data); the action fails (e.g., HTTP 404) if the repository is not starred or does not exist.
List accepted assignments for an assignment
Lists accepted assignments (student repositories created after acceptance) for an existing GitHub Classroom assignment, identified by its unique `assignment_id`.
List repositories accessible via GitHub App installation
Lists repositories that the authenticated user can access through a specific GitHub App installation. Returns repositories where the user has explicit :read, :write, or :admin permission through the installation. The response includes permission details for each repository. Prerequisites: - Requires a GitHub App user access token (not a standard OAuth token) - Use GITHUB_LIST_APP_INSTALLATIONS first to get valid installation IDs
List app installations for user token
Lists GitHub App installations accessible to the authenticated user via their access token, including installation details, permissions, and repository access.
Get apps with access to the protected branch
Lists GitHub Apps with push access to a repository's protected branch.
List artifacts for a repository
Lists GitHub Actions workflow artifacts for a specified repository, which must exist.
List assignees
Lists users who can be assigned to issues in a repository, typically those with push access.
List assignments for a classroom
Lists all assignments for a given GitHub Classroom `classroom_id`; the classroom must exist and be accessible.
List attestation repositories
Tool to list attestation repositories for an organization. Use when you need to discover which repositories in an organization have attestations. Attestations provide verifiable metadata about software artifacts.
List available machine types for a repository
Lists machine types available for GitHub Codespaces in a repository, optionally using a Git ref to check compatibility based on prebuild availability and devcontainer configurations.
List branches
Lists branches for an existing GitHub repository, with an option to filter by protection status.
List branches for head commit
Lists branches in an accessible repository where the provided commit SHA is the head, useful for identifying development lines based on that commit.
List check run annotations
Lists annotations for a specific check run in a GitHub repository, detailing issues like errors or warnings on particular code lines.
List check runs for a git ref
List GitHub check runs for a commit SHA, branch, or tag to assess CI status and conclusions. Use when you need reliable CI pass/fail signals beyond commit metadata.
List check runs in a check suite
Lists check runs for a specific check suite in a GitHub repository, optionally filtering by check name or status.
List check suites for a git reference
Lists check suites for a Git reference (commit SHA, branch, or tag) in a repository, optionally filtering by GitHub App ID or check run name.
List child teams
Lists the immediate child teams of a parent team within an organization.
List classrooms
Lists GitHub Classrooms to which the authenticated user has administrative access.
List codeowners errors
Lists syntax errors in a repository's CODEOWNERS file, which must be located at the root, `.github/`, or `docs/` directory for the specified ref.
List CodeQL databases for a repository
Lists all CodeQL databases for a repository where CodeQL analysis has been previously run and completed.
List code scanning alerts for an organization
Lists code scanning alerts for a GitHub organization; use EITHER `tool_name` OR `tool_guid` if filtering by tool, not both.
List code scanning alerts for a repository
Lists code scanning alerts for a repository, optionally filtering by tool (which must have produced scan results for the repository), Git reference, state, or severity.
List code scanning analyses for a repository
Lists code scanning analyses for an existing repository, optionally filtering by tool (name or GUID), Git reference, or SARIF ID.
Get all codes of conduct
Retrieves all available codes of conduct from GitHub, often used to select one for a repository.
List Codes of Conduct (GraphQL)
Tool to fetch all available codes of conduct using GitHub's GraphQL API. Use when you need to retrieve the complete list of codes of conduct that can be applied to repositories.
List codespaces for a user in organization
Lists all GitHub Codespaces owned by a specified member of a given organization.
List codespaces for the authenticated user
Lists GitHub Codespaces for the authenticated user, optionally filtering by repository ID and supporting pagination.
List codespaces for the organization
Lists active/pending GitHub Codespaces for an existing organization; admins list all, members list their own.
List comment changes across organization
Tool to list issue and PR comment changes across an organization's repositories efficiently. Use when monitoring comment activity without per-PR/per-issue polling. Filters organization events to return only comment-related events (IssueCommentEvent, PullRequestReviewCommentEvent, CommitCommentEvent). Note: Events are limited to the past 30 days and up to 300 events per timeline. Use ETag header for efficient polling to avoid rate limits.
List comments for a pull request review
Lists all comments for a specific review on a GitHub pull request.
List commit comments
Retrieves all comments for a specific commit in a GitHub repository, supporting pagination.
List commit comments for a repository
Lists all commit comments for a specified repository, which must exist and be accessible.
List commits
Lists commits for a GitHub repository. Requires 'owner' (username/org) and 'repo' (repository name) parameters. Optionally filter by SHA/branch, path, author, committer, or date range.
List commits on a pull request
Lists commits for a pull request; requires the repository and pull request to exist and be accessible, and supports pagination.
Get all commonly used licenses
Retrieves a list of commonly used software licenses from GitHub, optionally filtering for 'featured' licenses whose specific selection criteria by GitHub may vary.
Get all custom properties for an organization
Gets the schema definitions for all custom properties configured for an organization, not the specific values assigned to repositories.
Get all custom property values for a repository
Gets all custom property values for a repository. 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.
List custom property values for organization repositories
Lists repositories in an organization with their custom property values. Requires 'Custom properties' organization permission (read).
List deliveries for an organization webhook
Retrieves a list of webhook deliveries for a specific webhook in an organization, allowing inspection of delivery history and details.
List deliveries for a repository webhook
Retrieves delivery attempts for a specific repository webhook to inspect its history; ensure the webhook ID exists.
List deploy keys
Lists deploy SSH keys for a specified repository; the repository must exist.
List deployment branch policies
Lists all deployment branch policies for a specified environment in a GitHub repository.
List deployments
Lists deployments for a specified repository; repository must exist.
List deployment statuses
Lists all statuses for a given deployment in a repository.
List discussion comments
Lists all comments for a specific team discussion within an organization. Note: Team discussions are deprecated as of 2023-11-28. Consider using GitHub Discussions instead. This endpoint requires the authenticated user to be a member of the organization and have access to the team's discussions.
List discussions
Lists discussions for a specific team within an organization, with options for sorting, pagination, and filtering by pinned status. Note: Team discussions are deprecated as of 2023-11-28. Consider using GitHub Discussions instead. This endpoint requires the authenticated user to be a member of the organization and have access to the team's discussions.
List email addresses for the authenticated user
Lists all email addresses for the authenticated user, including their primary status, verification status, and visibility. This action retrieves the complete list of email addresses associated with the authenticated user, providing important details such as which email is primary and whether the emails are verified.
List environment custom deployment rules
Lists all custom deployment protection rule integrations for a repository environment; the `environment_name` must be URL-encoded.
List environments
Retrieves all deployment environments for a specified repository, which are used to configure protection rules and secrets for different software lifecycle stages.
List environment secrets
Lists the names and metadata (not values) of secrets for a specified, existing environment within an existing GitHub repository.
List environment variables
Lists all environment variables, which are plaintext key-value pairs for GitHub Actions workflows, for a specified environment within a GitHub repository.
List events for the authenticated user
Lists public events for the specified GitHub user, or private events if authenticated as that user, in reverse chronological order.
List events received by the authenticated user
Lists events a specific GitHub user received from followed users and watched repositories; returns private events if authenticated for `username`, otherwise public.
List followers of a user
Lists followers for a specified, existing GitHub user.
List followers of the authenticated user
Lists users following the authenticated GitHub user, returning an empty list if the user has no followers.
List forks
Lists forks for a specified repository, which must exist, with options for sorting and pagination.
List gist comments
Lists comments for a specified GitHub Gist.
List gist commits
Lists all commits for a specified gist.
List gist forks
Lists all forks for a given GitHub gist ID.
List gists for a user
_lists public gists for a specified GitHub user._
List gists for the authenticated user
Lists gists for the authenticated user, with optional filtering by update time and pagination.
List github actions caches for a repository
Lists GitHub Actions caches for a repository, with options to filter by Git reference or cache key, and to sort and paginate results.
List GitHub Pages builds
Lists GitHub Pages builds for a repository; GitHub Pages must be enabled on the repository for builds to be listed.
Get all gitignore templates
Retrieves all available .gitignore template names from GitHub (e.g., 'Python', 'Node', 'Java'), used for generating .gitignore files.
List global security advisories
Lists GitHub's global security advisories, filterable by various attributes including ID, type, ecosystem, severity, and dates.
List GPG keys for a user
Tool to list GPG keys for a GitHub user. Use when you need to fetch the public GPG keys associated with a specific GitHub user account.
List installation requests for the authenticated app
Lists pending installation requests made by users or organizations for the authenticated GitHub App.
List instances of a code scanning alert
Lists all instances of a specific code scanning alert, optionally filtered by Git ref; requires code scanning to be enabled on the repository.
List issue comments
Lists comments for a specified issue in a GitHub repository.
List issue comments for a repository
Lists issue comments, including those on pull requests, for an accessible repository.
List issue dependencies blocked by
Tool to list dependencies an issue is blocked by. Use when you need to retrieve all issues that are blocking a specific issue from being closed or completed.
List issue dependencies blocking
Tool to list dependencies an issue is blocking. Use when you need to see which issues are blocked by a specific issue.
List issue events
Retrieves a list of all events for a specific issue within a GitHub repository.
List issue events for a repository
Lists all issue events (e.g., closed, reopened, assigned) for a specified repository.
List issues for user
Lists GitHub issues for the authenticated user across visible repositories, with filtering by user relationship, state, labels, an ISO 8601 `since` timestamp (YYYY-MM-DDTHH:MM:SSZ), and sorting options; pull requests are typically included.
List issue types
List all issue types configured for a GitHub organization. Requires read:org scope for OAuth tokens.
List jobs for a workflow run
Lists jobs for a specific workflow run in a GitHub repository.
List jobs for a workflow run attempt
Lists jobs, including details like ID, status, and steps, for a specific attempt of a GitHub Actions workflow run.
List labels for an issue
Lists all labels for a specified issue in a GitHub repository.
List labels for a repository
Retrieves all labels for a specified, existing GitHub repository.
List labels for a self-hosted runner for a repository
Lists all labels assigned to a specific self-hosted runner registered with the given repository.
List labels for issues in a milestone
Lists all labels for issues within a specific milestone in a repository.
List labels for a self-hosted runner for an organization
Lists all labels assigned to a specific self-hosted runner within a GitHub organization, which are used to route workflows.
List Licenses (GraphQL)
Tool to fetch all known open source licenses using GitHub's GraphQL API. Use when you need to retrieve the complete list of licenses that can be applied to repositories.
List machine types for a codespace
Lists available machine types for a specific, accessible codespace, enabling it to be transitioned to a new hardware configuration.
List matching references
Lists all Git references (branches or tags) in a repository that start with the provided partial reference path (e.g., `heads/my-feature` or `tags/v1.2`).
List milestones
Lists milestones, which track progress for groups of issues and pull requests, for an existing repository, allowing filtering by state and sorting.
List notifications for authenticated user
Tool to list notification threads for the authenticated user with efficient polling support. Use when you need to fetch the user's GitHub notification inbox with filters like unread/participating/since. Returns notification threads plus polling headers (Last-Modified, ETag, X-Poll-Interval) for efficient polling. IMPORTANT: This endpoint requires a Personal Access Token (classic) with 'notifications' or 'repo' scope. It does NOT work with GitHub App tokens or fine-grained personal access tokens. If the token type is incompatible, a clear error message will be returned.
List notifications for the authenticated user (Deprecated)
DEPRECATED: Use GITHUB_LIST_NOTIFICATIONS instead. Lists notifications for the authenticated user, sorted by most recent update, with filtering and pagination options.
List org level codespaces secrets
Lists all Codespaces secrets available for a specified organization, which must exist.
List organization events for the authenticated user
Lists public events in a specified GitHub organization for the authenticated user's organization dashboard. Returns activities like repository pushes, pull requests, issues, forks, and other public events within the organization. The authenticated user must be a member of the organization to see events.
List organization members
Lists public and concealed members of a GitHub organization; viewing concealed members requires authenticated user to be an organization member.
List organization memberships for authenticated user
List organization memberships for authenticated user
List organization projects
Lists projects (V2) for a specified GitHub organization, with optional search query and cursor-based pagination.
List organization repositories
Retrieves a list of repositories for a specified GitHub organization, allowing filtering by type and sorting.
Get all organization roles for an organization
Lists all custom organization roles for an existing GitHub organization.
List organizations
Lists GitHub organizations for the authenticated user, sorted by ID in ascending order.
List organization secrets
Lists GitHub Actions secrets available for a specified organization.
List organizations for a user
Lists public organizations for a specified GitHub user; the `username` must be a valid GitHub handle.
List organizations for the authenticated user
Lists organizations the authenticated GitHub user is a member of, returning details for each organization.
List organization variables
Lists all GitHub Actions variables for a specified organization.
List organization webhooks
Lists all webhooks for a specified GitHub organization; the organization must exist.
List organization fine-grained permissions
Lists all fine-grained permissions available in a GitHub organization for use in custom organization roles. These permissions define granular access controls that can be combined when creating custom roles. Note: This endpoint requires GitHub Enterprise Cloud with the custom organization roles feature enabled. The authenticated user must be an administrator or have the 'read_organization_custom_org_role' permission.
List organization issues assigned to the authenticated user
Lists issues for the authenticated user within a specified GitHub organization, with options to filter by involvement type, state, labels, and to sort results.
List package versions for an organization package
Lists all versions for a specified package, if it exists and is owned by the given GitHub organization.
List organization project view items
Tool to list items for an organization project view. Use when you need to retrieve all items from a specific view within a GitHub organization's Projects V2 project. Returns a list of project items with their content, metadata, and field values.
List organization repositories with Github Actions enabled
Lists the selected repositories that are enabled for GitHub Actions in an organization. This endpoint only returns results when the organization's 'enabled_repositories' permission policy is configured to 'selected'. Requires admin:org scope and organization admin permissions.
List org resource access tokens
Lists approved fine-grained personal access tokens (PATs) with access to resources in a GitHub organization, optionally filtering by owner, repository, permissions, or last usage time. AUTHENTICATION REQUIREMENT: This endpoint requires GitHub App authentication with 'Personal access tokens' organization permissions (read). Standard personal access tokens CANNOT use this endpoint. The GitHub App must also have access to the organization.
List org resources with personal tokens
Lists requests from organization members to access organization resources with fine-grained personal access tokens (pending, approved, or denied). Note: This endpoint requires GitHub App authentication with 'organization_personal_access_token_requests:read' permissions; it cannot be used with personal access tokens.
List organization Dependabot secrets without values
Lists all Dependabot secrets (metadata like names, creation/update timestamps, but not their encrypted values) for a specified organization, which must exist.
List outside collaborators for an organization
Lists outside collaborators for a GitHub organization, with options to filter (e.g., by 2FA status) and paginate results.
List owned package versions
Lists all versions for an existing package owned by the authenticated user, identified by its type and name.
List packages for an organization
Lists GitHub Packages for an organization, noting specific interpretations for package_type and visibility parameters.
List packages for a user
Lists packages for a specified GitHub user, filterable by package type and visibility.
List packages for the authenticated user's namespace
Lists packages of a specific type and visibility within the authenticated user's namespace on GitHub.
List package versions for a package owned by a user
Lists all versions of a public package owned by a specific GitHub user, identified by package type, package name, and username.
List pending team invitations
Lists all pending membership invitations for a specified team within an organization. The authenticated user must be an organization member with the read:org scope. The response includes invitation details such as the invitee's login/email, the role they're being invited to, and who sent the invitation. The 'role' field indicates the type of invitation: - 'direct_member': Regular organization member - 'admin': Organization administrator - 'billing_manager': Billing manager role - 'hiring_manager': Hiring manager role - 'reinstate': Reinstating a previous member Note: If the invitee is not a GitHub member, the 'login' field will be null and only the 'email' field will be populated.
List project cards (Classic - Deprecated)
Lists all project cards for a given column_id in GitHub Projects (classic). 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/ Returns a list of project cards including: id, node_id, url, note (or null for linked cards), creator info, content_url (for issue/PR cards), column_url, project_url, timestamps, and archived status.
List project collaborators (classic)
Lists collaborators for a GitHub Project (classic) by project ID. IMPORTANT: This action uses the Projects (classic) REST API which was sunset on April 1, 2025 for GitHub.com. The API may still be available on GitHub Enterprise Server versions before 3.17. For GitHub.com users: GitHub Projects (classic) has been replaced by the new Projects experience. The new Projects does not have a REST API for listing collaborators - use the GitHub web interface to manage project collaborators instead. You must be an organization owner or a project admin to list collaborators.
List project columns
Lists all of a GitHub project's columns (e.g., 'To Do', 'In Progress'); project_id must identify a valid, accessible project. Note: This action uses GitHub's Projects (classic) REST API. The Projects (classic) API was sunset on April 1, 2025. This action will return an empty columns list with an informative message for projects that no longer exist or when the API returns 404.
List project fields for user
Tool to list all fields in a GitHub Projects V2 project for a specific user. Use when you need to see available fields in a project.
List project items for user
Tool to list items for a user-owned GitHub project. Use when you need to retrieve all items (issues, pull requests, draft issues) from a specific project belonging to a user.
List items for user project view
Tool to list items for a user's GitHub Projects (v2) view. Use when you need to retrieve items from a specific view of a user's project. Supports pagination and field filtering.
List public email addresses for the authenticated user
Lists the public email addresses for the authenticated user.
List public events
Lists public GitHub events, which may be delayed by up to 5 minutes, with support for pagination.
List public events for a network of repositories
Retrieves public events (up to 90 days old, newest first) for a GitHub repository network, including the repository and its forks.
List public events for a user
Retrieves a list of public events for a specified GitHub user, in reverse chronological order.
List public events received by a user
Lists public events for a specified GitHub user (e.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.
List public gists
Lists public gists from GitHub, optionally filtering by a 'since' timestamp and supporting pagination; results are generally newest first.
List public keys for a user
Lists the verified public SSH keys for a specified GitHub user.
List public organization events
Lists public events for a specified GitHub organization, which must exist. 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.
List public organization members
Lists users who have publicly declared their membership in a specified, existing GitHub organization.
List public repositories
Lists all public repositories on GitHub; use the `since` parameter with a repository ID from a previous result for pagination.
List pull requests
Lists pull requests for a GitHub repository. REQUIRES 'owner' AND 'repo' parameters - both are MANDATORY and must be provided in every call. 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.
List pull requests associated with a commit
Lists pull requests for a commit; returns merged PRs that introduced the commit if on the default branch, or open PRs including the commit if on other branches.
List pull requests files
Lists all files (including additions, modifications, and removals) associated with a specific pull request in a GitHub repository.
List reactions for a commit comment
Lists reactions for a specific commit comment; this is a read-only operation.
List reactions for an issue
Lists reactions for a specific, existing issue within an accessible GitHub repository, optionally filtering by content type.
List reactions for an issue comment
Lists reactions for a specific issue comment in a GitHub repository, optionally filtering by content type.
List reactions for a pull request review comment
Lists reactions for a pull request review comment in a repository, optionally filtering by reaction type.
List reactions for a release
Lists all reactions, or optionally filters reactions by a specific content type, for a given GitHub release.
List reactions for a team discussion
Lists reactions for an existing team discussion within an organization. This endpoint allows you to retrieve all reactions (emoji responses) made to a specific team discussion. You can optionally filter by reaction type. Note: OAuth app tokens and personal access tokens (classic) need the `read:discussion` scope to use this endpoint.
List reactions for a team discussion comment
Lists reactions for a specific comment in a team discussion within an organization, optionally filtering by content type.
List release assets
Lists assets (e.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.
List releases
Retrieves a list of all releases (published, draft, and prerelease) for a specified repository.
List repo access by token
Lists repositories in an organization that a fine-grained personal access token has requested access to. Only GitHub Apps can use this endpoint. Requires 'Personal access token requests' organization permissions (read).
List repo codespaces for authenticated user
Lists Codespaces the authenticated user can access within a specified, existing repository.
List repo dev container configs for user
Lists the `devcontainer.json` configurations available in a specified repository for use with GitHub Codespaces.
List authenticated user's repository invitations
Lists all pending repository invitations for the authenticated user.
List repository notifications for the authenticated user
Retrieves notifications for the authenticated user from a specified repository, to which the user must have access.
List repo secrets without values
Lists all Codespaces secrets available in a specific repository, without their encrypted values.
List repos accessible to app installation
Lists repositories a GitHub App installation can access. IMPORTANT: This endpoint requires a GitHub App installation access token (ghs_* prefix) for authentication. 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.
List repositories for a user
Lists public repositories for a specified GitHub user, who must have an existing account.
List repositories for the authenticated user
Lists repositories for the authenticated user; using 'type' with 'visibility' or 'affiliation' API parameters (not in this model) can cause a 422 error.
List repositories starred by a user
Lists repositories a valid and existing GitHub user has starred.
List repositories starred by the authenticated user
Lists repositories the authenticated user has starred, optionally sorted and paginated, including star creation timestamps via 'application/vnd.github.star+json' media type.
List repositories watched by a user
Lists repositories a given GitHub user is watching; the username must be a valid and existing GitHub user handle.
List repositories watched by the authenticated user
Lists repositories the authenticated user is watching (subscribed to for notifications). This action retrieves a list of repositories that the authenticated user is currently watching. It allows the user to manage their watched repositories effectively.
List repos with ghactions cache usage
Retrieves a paginated list of GitHub Actions cache usage statistics for repositories within an existing GitHub organization.
List repository activities
Lists activities for a GitHub repository, ensuring the repository exists and is accessible.
Get all autolinks of a repository
Retrieves all autolinks (e.g., for JIRA issues) configured for a repository; requires admin permissions on the repository.
List repository collaborators
Lists collaborators for a specified repository, provided it exists and is accessible to the authenticated user.
List repository contributors
Lists contributors to a specified repository, sorted by number of contributions in descending order; the repository must exist and be accessible.
List repository events
Lists chronological events (e.g., code pushes, issue activities, PR actions, forks) for a specified, existing GitHub repository.
List repository invitations
Retrieves all pending (unaccepted or undeclined) collaboration invitations for a specified GitHub repository.
List repository issues
Lists issues (including pull requests) from a GitHub repository. Requires BOTH 'owner' AND 'repo' parameters (e.g., owner='octocat', repo='Hello-World' for github.com/octocat/Hello-World).
List repository languages
Lists the programming languages used in a GitHub repository, returning a byte count for each language.
List repository organization secrets
Lists names of organization-level secrets shared with the specified repository; actual secret values are not returned and visibility depends on token access.
List repository organization variables
Lists organization-level variables that are shared with a specific repository. The repository must belong to an organization (not a personal account).
List repository projects
Lists Projects (classic) associated with a specific repository. Note: This action lists GitHub Projects (classic), which is GitHub's legacy project management feature. If the repository has Projects (classic) disabled or uses the newer Projects V2, this will return an empty list. Most modern repositories use Projects V2 (GraphQL API) instead of Projects (classic).
Get all repository rulesets
Retrieves all rulesets for a GitHub repository, which define conditions and actions for repository interactions (e.g., branch protections).
List repository rule suites
Lists rule suite evaluations for a repository, allowing filtering by ref (non-wildcard), time period, actor, and result.
List repository secrets
Lists metadata for all secrets in a GitHub repository, excluding their encrypted values.
List repository secrets without decrypting
Lists metadata (e.g., name, creation/update dates) for all Dependabot secrets in a repository; secret values are not included.
List repository security advisories
Tool to list security advisories for a repository. Use when you need to retrieve security advisories published for a specific repository, optionally filtered by state.
List repository tags
Lists tags for a specified GitHub repository.
List repository teams
Lists all teams with explicit permission to access the specified repository; the repository must exist.
Get all repository topics
Retrieves all topics for a specified, existing, and accessible repository.
List repository variables
Lists plain text key-value variables for GitHub Actions workflows within a specific, accessible repository.
List repository webhooks
Retrieves a list of webhooks for a repository, which must exist and be accessible.
List repository workflows
Lists all GitHub Actions workflows for a specified repository, which must exist and be accessible.
Get all requested reviewers for a pull request
Gets all users and teams requested to review a specific pull request in a repository.
List review comments in a repository
Lists all review comments on all pull requests within a specified repository.
List review comments on a pull request
Lists all review comments on a specific pull request within a GitHub repository.
List reviews for a pull request
Lists submitted reviews chronologically for a specific pull request within a GitHub repository.
List runner applications for an organization
Lists downloadable GitHub Actions runner application binaries for setting up self-hosted runners in a GitHub organization. Returns download URLs and checksums for various OS/architecture combinations (linux/win/osx on x64/arm/arm64). Requires admin:org scope or fine-grained 'Self-hosted runners' read permission.
List runner applications for a repository
Lists available self-hosted runner application binaries for a specific repository, including their OS, architecture, and download URL.
List secret scanning alerts for a repository
List secret scanning alerts for a GitHub repository using first-party detections. Use this to retrieve detected secrets with filtering by state, type, resolution, and validity. Supports optional hiding of secret literals for security.
List secrets for the authenticated user
Lists all Codespaces secrets accessible to the authenticated user for use within GitHub Codespaces.
List security advisories (GraphQL)
Tool to list GitHub Security Advisories using the GraphQL API. Use when you need to query security vulnerabilities and malware advisories from the GitHub Advisory Database with advanced filtering and pagination options.
List security vulnerabilities
Query software vulnerabilities documented by GitHub Security Advisories using GraphQL. Use this to find security issues in packages across ecosystems like npm, pip, maven, etc.
List selected repositories for a Codespaces organization secret
Lists repositories that have been granted access to a Codespaces organization secret. Returns all repositories that have been selected when the visibility for repository access to a Codespaces secret is set to 'selected'. Requires admin:org scope and admin access to the organization. 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.
List selected repositories for a user secret
Lists repositories that have access to the specified user Codespaces secret. This endpoint retrieves all repositories that the authenticated user has granted access to for a specific user-level Codespaces secret. The secret must already exist for this endpoint to work. Use 'list_secrets_for_the_authenticated_user' to discover available secrets first. Note: The authenticated user must have Codespaces access enabled. OAuth tokens and personal access tokens require the 'codespace' or 'codespace:secrets' scope.
List selected repos for secret access
Lists repositories within a specified organization that have been granted access to a particular Dependabot secret. Note: This endpoint only returns results when the secret's visibility is set to 'selected'. Secrets with visibility 'all' or 'private' do not have specific repository selections. Requires 'admin:org' scope and the user must have admin access to the organization.
List selected repositories for an organization variable
Lists repositories in an organization that can access a specific organization variable; supports pagination and returns an empty list if no repositories have been granted access. 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.
List self hosted runners for an organization
Lists self-hosted runners for a GitHub organization, optionally filtering by name and paginating results, providing details for each runner such as OS, status, and labels.
List self hosted runners for a repository
Lists all self-hosted runners configured for a repository.
List social accounts for a user
Lists social media accounts publicly linked to an existing GitHub user's profile.
List social accounts for the authenticated user
Lists all social media accounts linked to the authenticated user's GitHub profile. This action retrieves the social media accounts associated with the user's GitHub profile, allowing for easy management and visibility of connected accounts. The results include accounts such as Twitter, LinkedIn, and other platforms linked to the GitHub profile.
List Sponsorable Users and Organizations
Tool to list users and organizations who can be sponsored via GitHub Sponsors. Use when you need to discover sponsorable entities with optional filtering by dependency ecosystem.
List SSH signing keys for user
Lists the public SSH signing keys for a specified GitHub user.
List stargazers
Lists users who have starred the specified GitHub repository, which must exist.
List starred gists
Retrieves a list of gists starred by the authenticated user.
Get all status check contexts
Fetches all required status check contexts for a protected branch; returns an empty list if the branch isn't protected or has no required checks.
List sub-issues for an issue
Tool to list sub-issues for a specific GitHub issue. Use when you need to retrieve all sub-issues associated with a parent issue, supporting pagination for large hierarchies.
List marketplace subscriptions for authenticated user
Tool to list GitHub Marketplace subscriptions for the authenticated user. Use when you need to retrieve active marketplace app subscriptions including billing details, plan information, and trial status. Returns subscription information with account, plan, billing cycle, and pricing details.
List stubbed subscriptions for the authenticated user
Lists the authenticated user's stubbed (test/example data, not live) GitHub Marketplace subscriptions, useful for development or testing.
List tag protection states for a repository
DEPRECATED: Lists tag protection rules for a repository. This API was sunset on August 30, 2024. Use GITHUB_GET_ALL_REPOSITORY_RULESETS instead to view tag protection rules via repository rulesets.
List team members
Lists members of a specific team within an organization, including members of child teams.
List team projects
Lists GitHub projects accessible to a specific team within an organization.
List team repositories
Lists repositories accessible to a specific team within a GitHub organization. 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.
List teams
Lists teams for a specified GitHub organization.
List teams for the authenticated user
Lists all teams across all organizations to which the authenticated user belongs, supporting pagination.
List teams assigned to an organization role
Lists teams assigned to a specific role within a GitHub organization. This endpoint requires organization administrator privileges. Use this to audit which teams have been granted specific organization-level permissions through roles. Note: Organization roles is a feature for enterprise-level GitHub organizations.
List the people a user follows
Lists GitHub users that a valid GitHub `username` is following, supporting pagination.
List people the authenticated user follows
Lists people the authenticated user follows.
List timeline events for an issue
Lists chronological events (e.g., comments, commits, label changes) for a specific issue in a GitHub repository.
List token access repositories
Lists repositories in an organization that a fine-grained personal access token has access to. Requires organization admin permissions or 'Personal access tokens' organization read permission. Only GitHub Apps can use this endpoint.
List user projects
Retrieves a list of projects for a specified GitHub user, optionally filtering by state and supporting pagination; the username must be a valid GitHub handle. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects V1 REST API has been sunset by GitHub.
List users
Retrieves all GitHub users (individuals and organizations) in chronological order of their sign-up date.
List users blocked by an organization
Lists users blocked by a specified GitHub organization.
List users blocked by the authenticated user
Lists users blocked by the authenticated user, returning an empty list if no users are blocked.
List users assigned org role
Lists users assigned to a specific role within a GitHub organization.
List watchers
Retrieves a list of users watching a specific repository; the repository must be accessible to the authenticated user.
List workflow run artifacts
Lists artifacts (e.g., build outputs, test results) for a specific workflow run in a GitHub repository.
List workflow runs for a repository
Lists workflow runs for a repository, allowing filtering by actor, branch, event, status, creation date, check suite ID, or head SHA; the repository must exist and be accessible.
List workflow runs for a workflow
Lists runs for a specified, existing workflow (identified by ID or filename like `main.yml`) in a GitHub repository, with filtering options.
Lock an issue
Locks an existing GitHub issue's conversation, preventing further comments; an optional reason can be specified.
Lookup Enterprise Administrator Invitation
Tool to look up a pending enterprise administrator invitation by invitee, enterprise, and role. Use when you need to check if a specific user has a pending invitation to become an enterprise administrator.
Lookup GitHub Resource
Tool to lookup a GitHub resource by its URL. Use when you need to identify or retrieve information about a GitHub resource from its URL.
Lookup nodes by IDs
Tool to lookup GitHub nodes by their global node IDs. Use when you need to retrieve multiple objects by their IDs in a single batch query.
Lookup Organization (GraphQL)
Tool to lookup a GitHub organization by login using GraphQL. Use when you need organization information via GraphQL API.
Look Up Topic by Name
Tool to look up a GitHub topic by name using GraphQL. Use when you need to find information about a specific GitHub topic including its popularity (stargazer count) and related topics.
Manage access control for organization codespaces
Sets the Codespaces access control policy for a GitHub organization, determining which members can use them. This endpoint requires admin permissions on the organization. The API returns HTTP 204 No Content on success.
Manage custom properties for org repos
Creates or updates values for an organization's predefined custom properties across multiple repositories (up to 30).
List selected repositories for a GitHub Actions organization secret
Lists repositories within an organization that have been explicitly granted access to a specific GitHub Actions organization secret. Returns all repositories that have been selected when the visibility for repository access to an Actions secret is set to 'selected'. Requires admin:org scope and admin access to the organization. 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.
Map a commit author
Updates Git author information (name and/or email) for an `author_id` obtained during a repository import, to correctly attribute commits. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports.
Mark a thread as done
Marks the GitHub notification thread (identified by `thread_id`) as done or read for the authenticated user, effectively archiving it.
Mark a thread as read
Marks an existing GitHub notification thread, identified by its `thread_id`, as read.
Mark notifications as read
Marks notifications as read or unread, optionally for those updated at or before a `last_read_at` timestamp.
Mark repository notifications as read
Marks notifications in a repository as read; if 'last_read_at' is specified, notifications updated after this timestamp are not marked as read.
Merge a branch
Merges a head branch or commit SHA into a base branch in a repository; fails if there are merge conflicts requiring manual resolution.
Merge a pull request
Merges an open and mergeable pull request in a repository. A 405 error can occur for multiple reasons: (1) The PR is still in draft mode - convert it 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.
Move a project card (Classic - Deprecated)
Moves 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.
Move a project column (Classic - Deprecated)
Moves a column within a GitHub project (classic) to a new position. 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. The `position` parameter can be: - 'first': Move the column to the beginning of the project - 'last': Move the column to the end of the project - 'after:<column_id>': Place the column after the specified column (e.g., 'after:67890') See: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/
Ping an organization webhook
Sends a 'ping' event to a specified, existing organization webhook to test its configuration and ensure it correctly receives events.
Ping a repository webhook
Pings an existing webhook on a repository to test its configuration and reachability by GitHub.
Privately report a security vulnerability
Privately reports a security vulnerability to a repository's maintainers. IMPORTANT: You cannot report vulnerabilities to repositories you own - this API is for third-party security researchers to report to other repositories. The target repository must have private vulnerability reporting enabled. Specify EITHER `severity` OR `cvss_vector_string`, but not both.
Publish Sponsors Tier (GraphQL)
Tool to publish a draft GitHub Sponsors tier using GraphQL. Use when you need to make a draft sponsors tier visible to potential sponsors. The tier must already exist in draft status.
Redeliver a delivery for an organization webhook
Redelivers a specific webhook delivery for a webhook within an organization, to resend an event that previously failed or was not processed.
Redeliver a delivery for a repository webhook
Redelivers a specific, previously made webhook delivery (`delivery_id`) for a repository's webhook (`hook_id`).
Remove a custom property for an organization
Deletes a custom property, specified by `custom_property_name`, from an existing organization (`org`) for which the property is currently defined, preventing its future assignment to repositories.
Remove a label from an issue
Removes a label currently applied to a specific issue in a repository.
Remove all labels from an issue
Removes all labels from a specified issue in a GitHub repository; this operation is idempotent.
Remove all organization roles for a team
Revokes all organization roles for a team in an organization; this is destructive and succeeds even if the team initially has no roles.
Remove all organization roles for a user
Revokes all assigned organization-level roles from a specified user (who must be a member of the organization) within a GitHub organization, without removing the user from the organization or affecting repository-specific roles.
Remove an organization member
Removes a member from a GitHub organization. This action permanently removes a user's membership from the specified organization, revoking their access to all organization resources, repositories, and teams. Requirements: - The authenticated user must be an organization owner - The target user must currently be a member of the organization Note: This action cannot be used to remove the last owner of an organization.
Remove an organization role from a team
Revokes an organization role that a team currently possesses within an organization.
Remove an organization role from a user
Removes a custom organization role from a user within a GitHub organization, provided the organization exists, the user is a member, and the role_id corresponds to a valid custom role in that organization.
Remove app access restrictions
Removes all GitHub App access restrictions from a protected branch in a repository; the branch must have protection rules configured, and this action does not alter user or team restrictions.
Remove a project from a team
Removes a project from a team within an organization; this action requires the project to be currently associated with the team.
Remove a repository collaborator
Removes a collaborator from a specified GitHub repository, provided the repository exists and the user is an existing collaborator.
Remove a repository from an app installation
Removes a repository from a GitHub App installation for the authenticated user, given a valid `installation_id` and the `repository_id` of a repository currently linked to that installation; this operation is idempotent.
Remove a repository from a team
Disassociates a repository from a team; team members may lose access permissions, but the repository and team are not deleted.
Remove a selected repository from a user secret
Removes a selected repository's access to a user's Codespaces secret; the secret must exist and the repository must have previously been granted access.
Remove assignees from an issue
Removes specified assignees from a GitHub issue; requires push access, and invalid removal attempts are silently ignored.
Remove custom label from repo runner
Removes a custom label from a repository's self-hosted runner; this operation is idempotent.
Remove custom label from self hosted runner
Removes a currently assigned custom label (`name`) from a self-hosted runner (`runner_id`) in an organization (`org`). This action allows the organization to manage the labels associated with their runners effectively.
Remove custom labels from self hosted repo runner
Removes all custom labels from a self-hosted runner registered at the repository level, leaving only its default labels and any labels inherited from its runner group or organization.
Remove interaction restrictions for an organization
Removes all interaction restrictions from public repositories in the specified GitHub organization, allowing all users to resume interactions.
Remove interaction restrictions for a repository
Removes all interaction restrictions for a repository, enabling all users to comment, open issues, and create pull requests by lifting any existing temporary interaction limits.
Remove org dev env secret by name
Deletes a GitHub Codespaces secret from an organization by its name; this operation is idempotent.
Remove org secret by name
Permanently removes a specific Dependabot secret, by its `secret_name`, from the GitHub `org`, making it unavailable to Dependabot for that organization.
Remove outside collaborator from an organization
Removes a user, who must be an outside collaborator, from the specified GitHub organization, revoking their access to all its repositories.
Remove public org membership
Removes the authenticated user's public organization membership, making it private. 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.
Remove user public repo interaction restrictions
Removes all interaction restrictions (limitations on comments, issues, or pull requests) from all public repositories owned by the authenticated user.
Remove repository from organization dev environment secret
Removes a repository's access to an organization-level Codespaces secret, if it was previously granted.
Remove selected repo from org secret
Revokes a specific repository's access to an organization-level Dependabot secret, applicable only when the secret has 'selected' visibility and the specified repository currently has access.
Remove requested reviewers from a pull request
Removes currently assigned user logins and/or team slugs from a GitHub pull request's list of requested reviewers.
Remove selected repository from an organization secret
Removes a specific repository's access to an organization-level secret; the repository must have been previously granted access to this secret.
Remove selected repository from an organization variable
Removes a repository's access to an organization variable that has 'selected' visibility. This endpoint removes a specific repository from an organization variable's access list. The variable must have its visibility set to 'selected' for this operation to work. Returns a 409 Conflict error if the variable visibility is not 'selected'.
Remove status check contexts
Removes specified status check contexts from a protected branch's required status checks. This action removes the specified status check contexts from the existing list of required status checks for a protected branch. The branch must already have branch protection enabled with status checks configured. Note: The 'contexts' parameter is deprecated by GitHub in favor of 'checks' array. For new implementations, consider using update_status_check_protection with the 'checks' parameter instead.
Remove status check protection
Removes status check protection from a branch, disabling required status checks for merging pull requests; will only have an effect if status check protection is currently configured on the branch.
Remove team access restrictions
Removes specified teams from push access to a protected branch. This action removes teams from the list of teams with push access to a protected branch. Removing a team will also remove push access for any child teams. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must currently have push access to the branch
Remove team membership for a user
Removes a user from a specific team within an organization. This action requires admin:org scope permissions. It will fail if: - Team synchronization with an Identity Provider (IdP) is enabled (403 Forbidden) - The organization, team, or user membership doesn't exist (404 Not Found) - You don't have sufficient permissions to manage team memberships (403 Forbidden) Note: If the removed user was the last member and the team is not nested, the team may be deleted automatically.
Remove user access restrictions
Removes specified users from the list of people allowed to push to a protected branch. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must have protection rules with push restrictions enabled - Users being removed must currently have push access to the branch - The combined total of users, apps, and teams is limited to 100 items
Remove user as a collaborator (classic project)
Removes a user as a collaborator from an organization project (classic). IMPORTANT: This action uses the Projects (classic) REST API which is being deprecated. The Projects (classic) feature was sunset on GitHub.com. This API may still work on GitHub Enterprise Server versions before 3.17. Requirements: - You must be an organization owner or a project admin to remove a collaborator - The user must already be a collaborator on the specified project - The project must be an organization project (classic), not a Projects V2 project For GitHub.com users: Consider using GitHub Projects V2 instead, which can be managed through the GraphQL API.
Remove users from codespaces access for an organization
Removes selected users from GitHub Codespaces billing access for an existing organization.
Rename a branch
Renames an existing branch in a GitHub repository; the new name must be unique and adhere to GitHub's naming conventions, and the current branch name cannot contain wildcard characters.
Render a markdown document
Renders Markdown to HTML; for 'gfm' mode, provide 'context' (owner/repo) to correctly link issues, pull requests, and user mentions.
Render Markdown (Raw Mode)
Tool to render raw Markdown text to HTML using GitHub's markdown API. Use when you need to convert plain Markdown content to HTML without GitHub-specific features like issue references or @mentions.
Replace all repository topics
Replaces all topics of a repository.
Replace org secret visibility to selected
Replaces the list of repositories that can access a Dependabot organization secret when the secret's visibility is already set to 'selected'.
Replace repository access for an org Codespaces secret
Replaces the list of repositories that can access an organization-level Codespaces secret. This operation completely replaces the existing list of repositories with the provided list. The secret must already have its visibility set to 'selected' for this operation to succeed. Use this when you want to set an exact list of repositories that should have access. Prerequisites: - The organization must exist and you must have admin:org scope - The Codespaces secret must already exist in the organization - The secret's visibility must be set to 'selected' (not 'all' or 'private') Returns HTTP 204 No Content on success, 404 if secret/org not found, 409 if visibility is not 'selected'.
Request a github pages build
Manually triggers a GitHub Pages build for a repository if GitHub Pages is enabled, useful for deployments not automatically built or for retrying failed builds.
Add reviewers to a specific pull request
Adds reviewers to a specific pull request identified by owner, repo, and pull_number. This is NOT a search action - it operates on an already-known PR number. Requires `owner`, `repo`, `pull_number`, and at least one of `reviewers` or `team_reviewers`.
Rerequest a check run
Triggers a re-run of a specific check run in a GitHub repository, resetting its status to 'queued', clearing its conclusion, and triggering the `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.
Rerequest a check suite
Triggers a new run of an existing check suite within a repository, resetting its status to 'queued', clearing its conclusion, and triggering the `check_suite` webhook with `rerequested` action. IMPORTANT: This endpoint requires GitHub App authentication with 'checks:write' permission. OAuth tokens and classic personal access tokens (PAT) cannot use this endpoint. Only GitHub App user access tokens, GitHub App installation access tokens, or fine-grained personal access tokens with checks:write permission are supported.
Re-run a job from a workflow run
Re-runs a specific job and any dependent jobs from a GitHub Actions workflow run in the specified repository, optionally enabling debug logging.
Rerun a workflow
Re-runs a specific GitHub Actions workflow run identified by its owner, repository, and run ID, optionally enabling debug logging.
Rerun failed jobs from a workflow run
Re-runs all failed jobs and their dependent jobs from a specified workflow run if the run contains previously failed jobs.
Reset a token
Invalidates the provided OAuth `access_token` and generates a new one for the GitHub OAuth App identified by `client_id`. Used for token rotation when a token may be compromised or for regular security maintenance. Note: This endpoint requires the OAuth App owner's credentials (client_id/client_secret for Basic Auth).
Restore a package for an organization
Restores a package in an organization, provided it was deleted within the last 30 days.
Restore a package for a user
Restores a user-owned package previously deleted from GitHub Packages, if restorable under GitHub's data retention policy (typically within 30 days of deletion).
Restore a package for the authenticated user
Restores a package deleted by the authenticated user within the last 30 days, if its namespace and version are still available.
Restore a package version for the authenticated user
Restores a package version that was deleted by the authenticated user within the last 30 days.
Restore package version for an organization
Restores a package version for an organization, provided it was deleted within the last 30 days.
Restore package version for a user
Restores a specific, user-owned package version if it was deleted within the last 30 days and its original namespace and version name are still available.
Retire Sponsors Tier
Tool to retire a published payment tier from your GitHub Sponsors profile using GraphQL. Use when you need to prevent a tier from being used for new sponsorships. Existing sponsors at this tier remain unaffected.
Review access with personal token
Approves or denies a pending fine-grained personal access token request for organization resources; must be performed by a GitHub App.
Review Custom Deployment Rules For Workflow Run
Approves or rejects pending custom deployment protection rules for a workflow run. This endpoint allows GitHub Apps to review their own pending custom deployment protection rules for a specific workflow run. The review can either approve (allowing the deployment to proceed) or reject (blocking the deployment). **Important notes:** - GitHub Apps can only review their own custom deployment protection rules - This endpoint requires GitHub App installation access tokens with Deployments permission (write) - Custom deployment protection rules are available in public repos for all plans; for private/internal repos, GitHub Enterprise is required - Returns 204 No Content on success
Review pending deployments for a workflow run
Approves or rejects pending deployments for a specific workflow run that are in a 'waiting' state within specified, configured environments.
Review PAT Requests in Bulk
Approves or denies multiple fine-grained personal access token requests for an organization in bulk. This endpoint processes multiple PAT request approvals or denials in a single API call. All specified pat_request_ids must refer to currently pending requests. Important: This endpoint can ONLY be called by GitHub Apps with the 'organization_personal_access_token_requests:write' permission. It cannot be called with personal access tokens or OAuth apps. On success, returns HTTP 202 Accepted with an empty body.
Revoke an installation access token
Revokes the GitHub App's current installation access token, immediately invalidating it for API authentication. IMPORTANT: This endpoint requires a GitHub App installation access token (ghs_* prefix) for authentication. OAuth tokens (gho_*) or personal access tokens are not supported and will result in a 403 Forbidden error. After successful revocation, the token becomes permanently invalid and cannot be used for any subsequent API calls. To continue API operations, a new installation access token must be generated.
Run GraphQL Query
Tool to run an arbitrary GitHub GraphQL v4 query or mutation. Use when fetching multiple datasets in one batch. Cost-based rate limit: ~5,000 points/hour; keep field selections narrow, avoid deep nesting, and include rateLimit in responses to monitor quota. Responses are nested under data.data (e.g., data.data.repository.vulnerabilityAlerts); always inspect the errors array even on HTTP 200, as partial failures embed there. Paginate by looping on pageInfo.hasNextPage and advancing with pageInfo.endCursor. Search results cap at ~1,000 items per query; split by label, date range, or repository for full coverage. Use ProjectV2 nodes, not Classic Projects (deprecated). Parallel mutations (e.g., addProjectV2ItemById) can trigger transient conflicts; use sequential execution.
Run GraphQL Relay Query
Tool to run a GitHub GraphQL relay query. The relay field is a workaround for re-exposing the root query object. Use when you need to access root query fields through the relay context.
Search code
Searches code file contents and paths on the default branch of GitHub repositories using a query string; searches only files under 384KB, returns max 1000 results by best match, and is optimized for precision.
Search code (all pages)
Tool to search code across multiple pages using GitHub's code search API. Use when single-page searches may miss matches and you need a full or capped result set. GitHub caps results at ~1,000 total items regardless of pagination; results for broad queries may be silently truncated. Only the default branch is indexed, and very large files may be excluded — treat results as potentially partial. Rate limit: ~30 requests/minute; honor `Retry-After` on 403/429 responses.
Search commits
Finds commits on GitHub using a query string (q) supporting keywords and qualifiers, with options for sorting and pagination.
Search commits by author across repos
Searches commits across GitHub using the Search API (e.g., by author/email/org/date range) without per-repo scanning. Use when you need to find commits by author, committer email, organization, or date ranges across multiple repositories. This avoids the need to list commits per repository and prevents 409 errors on empty repos.
GitHub GraphQL Search
Tool to perform GitHub GraphQL searches across issues, pull requests, repositories, users, and discussions. Returns up to 1,000 results with cursor-based pagination. Use when you need structured search results with specific fields.
Search issues and pull requests
Searches GitHub for issues and pull requests. Supports keywords, qualifiers (repo:, org:, user:, state:, label:, author:, assignee:, mentions:, etc.), and type filters (is:issue, is:pr). Type filters cannot be used alone - they must be combined with at least one keyword or other qualifier. All other qualifiers work independently. The @me shorthand (e.g., assignee:@me, mentions:@me) is automatically resolved to your username. Logical operators (AND, OR, NOT) are supported but limited to a maximum of 5 operators total per query.
Search labels
Searches for labels within a GitHub repository by keywords in their names or descriptions.
Search repositories
Searches GitHub repositories using a flexible query (keywords, qualifiers) with sorting, ordering, and pagination. IMPORTANT: The 'q' parameter (search query) is REQUIRED and must always be provided.
Search topics
Finds topics on GitHub using keywords and qualifiers with GitHub's search syntax, supporting pagination.
Search users
Searches for users on GitHub by criteria like username, email, location, followers, or repository associations, using a flexible query string `q`.
Set admin branch protection
Enables administrator enforcement on a branch, making existing protection rules also apply to administrators; branch protection rules must already be configured.
Set app access restrictions
Replaces the list of GitHub Apps permitted to push to a protected branch. This action completely replaces the existing list of apps with push access - it does not add to or merge with the current list. Requirements: - The branch must already have protection rules enabled with push restrictions configured - Apps must be installed on the repository and have 'contents' write permission - Push restrictions are only available for organization-owned repositories with GitHub Team or Enterprise Cloud plans
Set a repository subscription
Sets the authenticated user's notification subscription for a repository.
Set a thread subscription
Sets whether a GitHub notification thread is ignored (muted) or unignored (unmuted), for a `thread_id` that must identify an existing notification thread.
Set default workflow permissions for an organization
Updates an organization's default GITHUB_TOKEN permissions for workflows and whether GitHub Actions can approve pull requests; note that allowing Actions to approve pull requests (`can_approve_pull_request_reviews: true`) is a security risk.
Set default workflow permissions for a repository
Sets the default permissions for the GITHUB_TOKEN within a repository and configures whether GitHub Actions can approve pull requests.
Set primary email visibility
Sets the visibility ('public' or 'private') of the authenticated user's primary email address on GitHub, if one is configured.
Set GitHub Actions permissions for an organization
Sets the GitHub Actions permissions policy for an organization, specifying which repositories can run Actions and which actions/workflows are allowed; if 'selected' is chosen for either, manage the specific lists via other endpoints.
Set github actions permissions for a repository
Sets GitHub Actions permissions for a repository, enabling/disabling Actions and defining the policy for allowed actions and reusable workflows.
Set interaction restrictions for an organization
Limits interactions (comments, new issues, PRs) in an organization's public repositories by user type and duration, typically to mitigate high traffic or unwanted activity.
Set interaction restrictions for a repository
Temporarily limits which GitHub users (e.g., existing_users, contributors_only) can interact (comment, open issues, create pull requests) in a repository for a specified duration.
Set interaction restrictions for your public repositories
Sets or updates temporary interaction restrictions for all public repositories owned by the authenticated user, overriding any repository-specific limits.
Set labels for an issue
Replaces all existing labels on a GitHub issue with a new set of labels.
Set custom OIDC subject claim template
Sets the OpenID Connect (OIDC) subject claim template for a GitHub repository, allowing use of the default template or a custom one defined by `include_claim_keys` if `use_default` is `false`.
Set allowed actions and workflows for an organization
Sets the GitHub Actions permissions for an existing organization, specifying allowed GitHub-owned actions, verified creator actions, and action/workflow patterns from public repositories.
Set custom labels for a self-hosted runner for an organization
Sets the custom labels for a self-hosted runner in an organization; this operation does not affect default system-assigned labels (e.g., 'self-hosted', 'linux', 'x64').
Set repo allowed actions
Sets allowed GitHub Actions and reusable workflows for a repository, managing permissions for GitHub-owned, verified creator, or specific pattern-matched actions/workflows (note: `patterns_allowed` applies only to public repositories).
Set custom labels for repo runner
Replaces all custom labels for a specific self-hosted runner in a repository; an empty list for `labels` removes all existing custom labels.
Set selected repositories for an organization variable
Replaces the list of repositories that can access an organization-level variable; the variable's visibility must be 'selected'.
Set selected repositories for an organization secret
Replaces the list of repositories that can access an organization secret; only effective if the secret's visibility is 'selected'. Prerequisites: - The organization secret must already exist - The secret's visibility must be set to 'selected' (not 'all' or 'private') - Requires admin:org scope or actions secrets fine-grained permission This action completely replaces the repository access list. To add or remove individual repositories without affecting others, use the dedicated add/remove repository actions instead.
Set selected repositories for a user secret
Defines the list of repositories permitted to access a specific Codespaces secret for the authenticated user.
Set status check contexts
Replaces required status check contexts for a protected branch, requiring admin permissions; an empty `contexts` array removes all checks.
Set team access restrictions
Replaces the list of teams with push access to a protected branch. This action sets (replaces) the teams that have push access to a protected branch. Unlike 'Add team access restrictions' (POST), this action replaces the entire list rather than adding to it. Use an empty list to remove all team restrictions. Prerequisites: - The repository must be owned by an organization (not a personal account) - The branch must have protection rules enabled - The branch protection must have restrictions configured - The teams must exist in the organization and have repository access
Set user access restrictions
Replaces the list of users with push access to a protected branch in an organization repository. Important notes: - This action only works on organization-owned repositories (not personal repos) - The branch must already have protection rules with restrictions enabled - This REPLACES (not adds to) the existing list of users with push access - Users must have write access to the repository to be added - The combined total of users, apps, and teams is limited to 100 items - To add users without replacing, use the 'add_user_access_restrictions' action instead
Set User Interaction Limit (GraphQL)
Tool to set interaction limits on a user's public repositories using GraphQL. Use when you need to temporarily restrict who can comment, open issues, or create pull requests. Limits apply to the authenticated user or a specified user.
Set workflow access level outside repository
Sets the access level for workflows outside a repository to use actions and reusable workflows within that repository.
Star a gist
Stars a GitHub gist identified by `gist_id`; this action is idempotent and returns a 204 No Content status upon success, even if the gist is already starred.
Star a specified repository (requires owner and repo)
Stars a specified repository (identified by owner and repo name) for the authenticated user; this action is idempotent and succeeds even if the repository is already starred. Requires explicit repository identification via owner and repo parameters.
Start a codespace for the authenticated user
Initiates the startup process for an existing GitHub Codespace (identified by `codespace_name`) if it's in a startable state like 'Available' or 'Stopped'.
Stop a codespace for an organization user
Stops a running codespace for an organization member. This action allows organization administrators to stop a codespace that belongs to a member of their organization. The codespace must be in a running state (e.g., 'Available') to be stopped. Required permissions: - OAuth/PAT: admin:org scope - Fine-grained tokens: 'Organization codespaces' (write) or 'Codespaces lifecycle admin' (write) Common HTTP responses: - 200: Codespace successfully stopped, returns codespace object - 304: Not modified (codespace already stopped) - 401: Authentication required - 403: Insufficient permissions (need admin:org) - 404: Organization, user, or codespace not found
Stop a codespace for the authenticated user
Stops a running or available Codespace for the authenticated user, pausing its execution and billing.
Submit a review for a pull request
Finalizes a pending pull request review (identified by `review_id`) with a required `event` (APPROVE, REQUEST_CHANGES, COMMENT) and an optional `body`.
Sync a fork branch with the upstream repository
Synchronizes a branch in a forked GitHub repository with its upstream counterpart, assuming the repository is a fork, the branch exists, an upstream is configured, and the merge is conflict-free.
Test the push repository webhook
Triggers a simulated push event to test a repository's push webhook; a test event is only delivered if the webhook is subscribed to 'push' events, otherwise, it returns 204 No Content without sending a POST.
Transfer a repository
Initiates a repository transfer to a new owner (who must accept the request); if the new owner is an organization, it must be configured to allow transfers.
Unblock a user
Unblocks a GitHub user, provided they are currently blocked by the authenticated user.
Unblock a user from an organization
Unblocks a user from an organization, allowing renewed interaction with its resources, provided the user is currently blocked (otherwise, a 404 error may occur).
Unfollow a user
Unfollows an existing GitHub user; this action is idempotent, succeeding even if the authenticated user is not currently following them.
Unfollow organization
Tool to unfollow a GitHub organization using GraphQL. Use when you need to stop following a specific organization on GitHub.
Unfollow user
Tool to unfollow a GitHub user using GraphQL. Use when you need to stop following a specific user on GitHub.
Unlock an issue
Unlocks a currently locked GitHub issue in the specified repository, allowing new comments and interactions.
Unlock an organization repository
Unlocks a repository that was locked for migration within a GitHub organization. This action is part of the organization migrations workflow. When you start a migration with `lock_repositories=true`, the source repositories are locked to prevent changes during export. After the migration is complete and applied to the target instance, use this action to unlock the repositories so they can be accessed or deleted. Requirements: - You must be an organization owner to unlock repositories - The repository must be currently locked as part of the specified migration - This endpoint does not work with GitHub App tokens or fine-grained personal access tokens Typical workflow: 1. Start an organization migration with POST /orgs/{org}/migrations 2. Wait for the migration to complete (state: "exported") 3. Apply the migration to your target instance 4. Unlock each migrated repository using this action 5. Delete the source repositories if no longer needed
Unlock a user repository
Unlocks a repository (`repo_name`) that was locked as part of a user migration (`migration_id`), making it usable or deletable; this action requires the repository to be currently locked.
Unstar a gist
Removes a star from the specified gist; the action is idempotent and will not error if the gist was not previously starred by the user.
Unstar a repository
Removes the authenticated user's star from a specified repository, which must already be starred by the user.
Update a check run
Updates an existing check run for a specific commit in a repository, allowing modifications to its status, conclusion, output, and other details. NOTE: This endpoint requires GitHub App authentication with 'checks:write' permission - OAuth tokens and personal access tokens cannot update check runs.
Update a code scanning alert
Updates a specific code scanning alert in a GitHub repository, primarily to change its state (e.g., 'open' or 'dismissed').
Update a commit comment
Changes the body of an existing commit comment.
Update a custom organization role
Updates an existing custom role in an organization by modifying its name, description, or permissions; at least one of these fields must be provided.
Update a deployment branch policy
Updates the name pattern of an existing deployment branch policy for a specific environment in a repository.
Update a discussion
Updates the title and/or body of a specific team discussion within an organization.
Update a discussion comment
Updates the body of a comment in a team's discussion within an organization.
Update a gist
Updates a gist's description, and/or its files (including content, filename changes, or deletion).
Update a gist comment
Updates an existing comment on a specified gist.
Update a label
Updates an existing label's name, color, or description within a specified repository.
Update a milestone
Updates a milestone in a repository, identified by `owner`, `repo`, and `milestone_number`, by allowing modification of its `title`, `state`, `description`, or `due_on`; at least one of these four attributes must be provided to perform an update.
Update an environment variable
Updates an existing environment variable's name and/or value in a specific GitHub repository environment; requires providing either a new name or a new value.
Update an issue
Updates an existing GitHub issue's title, body, state, milestone, labels, or assignees; `state_reason` is only processed if `state` also changes, and use `null` or `[]` to clear applicable fields.
Update an issue comment
Updates an existing comment on an issue or pull request within a specified repository. You can only update comments that the authenticated user has permission to edit. The comment_id can be obtained from the list_issue_comments or get_an_issue_comment actions.
Update an organization
Updates an organization's settings; changing security-related fields requires admin, owner, or security manager permissions.
Update an organization variable
Updates an existing GitHub Actions organization variable's name, value, or visibility (`all`, `private`, `selected`), requiring `selected_repository_ids` with valid repository IDs if visibility is `selected`.
Update an organization webhook
Updates the configuration (URL, content type, secret, SSL verification), subscribed events, active status, or name of an existing webhook for a specified organization.
Update a project
Updates an existing GitHub project (V2) attributes like title, description, visibility, and state. Note: This action uses GitHub's Projects V2 GraphQL API. The legacy Projects (classic) REST API was sunset on April 1, 2025. The project is identified by its number (visible in the project URL) and owner (either a username or organization name). If no owner is specified, the authenticated user is assumed. At least one field to update must be provided.
Update a pull request
Updates an existing pull request, allowing changes to attributes like title, body, state, base branch, and maintainer modification settings.
Update a pull request branch
Updates an open pull request's head branch by merging the latest changes from its base branch, if mergeable and repository merging is enabled; operates asynchronously.
Update a reference
Updates an existing Git reference (e.g., a branch or tag) to point to a specific commit SHA. By default, only allows fast-forward updates (where the new commit is a descendant of the current one). Set `force=true` to allow non-fast-forward updates that rewrite history. IMPORTANT: The reference must already exist - use 'Create a reference' action to create new refs.
Update a release
Updates an existing release in a GitHub repository, allowing modification of its attributes; if linking a discussion, the `discussion_category_name` must refer to an existing category in the repository.
Update a release asset
Updates the name, label, or state of a release asset in a GitHub repository, requiring at least one of these properties to be provided for modification.
Update a repository
Updates settings for an existing GitHub repository, such as name, description, visibility, merge strategies, and security configurations.
Update a repository invitation
Updates an active repository invitation to modify the invited user's permissions; the specified repository and invitation must exist.
Update a repository ruleset
Updates an existing repository ruleset, identified by `ruleset_id` for a given repository, allowing partial updates to its configuration such as name, target, enforcement, bypass actors, conditions, and rules.
Update a repository variable
Updates the name and/or value of an existing GitHub Actions variable in a repository.
Update a repository webhook
Updates the URL, content type, secret, SSL verification, events, or active status for an existing repository webhook, specified by `owner`, `repo`, and `hook_id`.
Update a team
Updates a team's settings (e.g., name, description, privacy, parent team) within a GitHub organization, identified by its slug and organization name.
Update branch protection
Updates the protection settings for an existing branch in a repository, which must not contain wildcard characters.
Update a code scanning default setup configuration
Updates the default setup configuration for code scanning in a repository; GitHub Advanced Security must be enabled for the repository.
Update a codespace for the authenticated user
Updates an existing GitHub Codespace's machine type, display name, or recent folders for the authenticated user; machine type changes take effect on the next start.
Update Git LFS Preference
Sets the Git Large File Storage (LFS) preference for a repository during a source import. NOTE: This endpoint has been deprecated by GitHub as of April 12, 2024, and is no longer available. The Source Imports REST API has been retired due to very low usage levels. Please use the GitHub Importer tool at https://github.com/new/import for repository imports.
Update issue type
Update an existing issue type for a GitHub organization. Requires the authenticated user to be an organization administrator. OAuth tokens need admin:org scope.
Update a webhook configuration for an organization
Updates the configuration (URL, content type, secret, SSL verification) for an existing webhook within a specified organization.
Update an existing project card (Classic - Deprecated)
Updates 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/
Update an existing project column (Classic - Deprecated)
Updates 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/
Update a review for a pull request
Updates the body text of an existing pull request review.
Update a review comment for a pull request
Updates the body of an existing review comment on a pull request.
Update pull request review protection
Updates pull request review protection settings (e.g., required approvals, review dismissal, bypass allowances) for a branch; branch protection features must be available for the repository.
Update repository preferences for check suites
Updates repository preferences for automatic Check Suite creation on code pushes, allowing configuration for specific GitHub Apps that must be installed on the repository with `checks:write` permission.
Update a webhook configuration for a repository
Updates the configuration (e.g., payload URL, content type, secret, SSL verification) for an existing webhook in a specified repository.
Update resource access with tokens
Revokes organization access for the personal access tokens identified by `pat_ids`; this action must be performed by a GitHub App, and `pat_ids` must 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.
Update status check protection
Updates required status checks for a branch, optionally requiring it to be up-to-date before merging.
Update Subscription
Tool to update notification subscription state for issues, pull requests, or discussions. Use when you need to subscribe, unsubscribe, or ignore notifications for a specific GitHub item.
Update the authenticated user
Updates the authenticated user's GitHub profile; a new public email must be verified, and existing private emails remain private even if specified.
Revoke Token Organization Access
Revokes a fine-grained personal access token's access to an organization. IMPORTANT: This endpoint can ONLY be called by GitHub Apps with 'Personal access tokens' organization permissions (write). Personal access tokens (PATs) cannot use this endpoint. Use GITHUB_LIST_ORG_RESOURCE_ACCESS_TOKENS to get valid pat_id values for tokens that have access to your organization.
Update User List
Tool to update an existing GitHub user list. Use when you need to modify the name, description, or privacy settings of a user list.
Update user lists for item
Tool to update which of the viewer's lists an item belongs to on GitHub. Use when you need to add an item (repository, issue, pull request, etc.) to specific user lists or move it between lists.
Update Project V2 Item for User
Tool to update a field value for an item in a user's GitHub ProjectV2. Use when you need to modify a field value of an existing project item.
Change User Status
Tool to update your status on GitHub. Use when you need to set or clear your GitHub profile status with an emoji, message, and availability indicator.
Upload a release asset
Tool to upload a binary asset to an existing GitHub release. Use when you need to attach files like installers or backups to a release programmatically.
Upload an analysis as sarif data
Uploads a gzipped and Base64 encoded SARIF file to a GitHub repository for a specific commit and reference; use `checkout_uri` if SARIF paths are absolute.
Create or update repository custom property values
Creates or updates up to 30 custom property values for a repository; custom properties must be predefined at the organization or repository level, and setting a property's value to `null` removes it.
Verify dev container permissions accepted
Verifies if the authenticated user has accepted permissions for a specific devcontainer configuration in a repository, typically to ensure awareness before a codespace is created or used.
1password
Password manager and digital vault for secure credential storage and team collaboration
2chat
2Chat provides a programmable API for integrating WhatsApp and other text channels, enabling developers to send and receive messages, manage groups, and automate workflows.
Ably
Ably is a real-time messaging platform helping developers build live features, including chat and data synchronization, with global scalability and robust reliability for modern applications
Abstract
Abstract API provides a suite of APIs for developers to automate various tasks, including data validation, enrichment, and more.
Addressfinder
A reliably smart, reliably accurate data quality platform for address, email, and phone verification
Addresszen
AddressZen provides address autocomplete and verification services, offering real-time address suggestions and validation to ensure accurate and deliverable addresses.
Frequently asked questions
What can I automate with GitHub on Definable?
Anything GitHub exposes through its API. Common developer tools workflows on Definable include triage issues, review pull requests, monitor builds. Personas can call any of the 867 GitHub tools directly, or react to its 46 triggers, then chain the result into another integration without you writing code.
How does GitHub authentication work?
GitHub uses OAUTH2 on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Is the GitHub integration included in my Definable plan?
Yes — every Definable plan, including Starter, includes access to all 867 GitHub tools. You only need a separate GitHub subscription if GitHub itself charges per seat or per API call.
Is using GitHub through Definable secure?
Every call from a persona to GitHub is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
How do I get started with GitHub on Definable?
Sign up for Definable, open the integrations page, find GitHub, and connect via OAuth or API key. You can immediately attach GitHub to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
What GitHub actions does Definable expose?
Definable exposes all 867 GitHub actions as callable tools — including `Abort Repository Migration`, `Accept a repository invitation`, `Add app access restrictions`, plus 864 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Ready to automate with GitHub?
Wire it up in minutes. No coding required.