Skip to Content

GitHub API

GitHub API icon
Arcade Starter

Tools that enable LLMs to interact directly with the GitHub API.

Author:Arcade
Version:1.0.0
Auth:User authorization via the Github auth provider
818tools
818require secrets
PyPI VersionPython VersionsWheel StatusDownloadsLicense

Arcade Toolkit enables seamless interaction between LLMs and the GitHub API, allowing for efficient management and development of GitHub repositories. It provides developers with tools for automation, collaboration, and project management.

Capabilities

  • Automate GitHub actions and workflows for repositories.
  • Manage branches, access permissions, and team collaborations.
  • Handle repository secrets, issues, pull requests, and releases.
  • Perform analytics on contributions, notifications, and security alerts.
  • Integrate GitHub Apps and customize environment settings.

OAuth

Provider: Github
Scopes: None

Secrets

The toolkit supports several types of secrets such as GitHub tokens, webhooks, and environment variables. For example, it allows the management of GIT_SERVER_URL securely.

Available tools(818)

818 of 818
Tool nameDescriptionSecrets
Accept a GitHub repository invitation. This tool accepts an invitation to join a GitHub repository for the authenticated user. Use it when you need to confirm participation in a repo after receiving an invitation.
1
Grant specified apps push access to a protected branch. Use this tool to grant specific GitHub Apps push access to protected branches in repositories. Apps must have 'write' access to 'contents' to be authorized. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
1
Add custom labels to a self-hosted runner in an enterprise. Use this tool to attach custom labels to a self-hosted runner within an enterprise on GitHub. Requires authentication with a token that has the `manage_runners:enterprise` scope.
1
Add a new email to the authenticated GitHub user's account. Use this tool to add an email address to the authenticated GitHub account of the user. This action requires user scope authentication. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
1
Add an authorized SSH key to GitHub Enterprise. This tool adds an authorized SSH key to a GitHub Enterprise account. It is useful when you want to securely access your GitHub repositories using SSH. Make sure to provide the SSH key in the required format.
1
Add a reaction to a GitHub release. Use this tool to create a reaction to a specific release on GitHub. If a reaction already exists, it will return a confirmation with status 200 OK.
1
Add a GPG key to your authenticated GitHub account. This tool allows you to add a GPG key to your GitHub account after authenticating via Basic Auth or OAuth with the appropriate scope. Use it to enhance security by managing GPG keys on GitHub.
1
Add labels to a GitHub issue to categorize it. Use this tool to apply one or more labels to a specific issue in a GitHub repository. It helps in categorizing and organizing issues for better project management. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
1
Add custom labels to a self-hosted runner in an organization. This tool adds custom labels to a self-hosted GitHub Actions runner configured in an organization. Use this tool when you need to organize or categorize runners with specific labels. Requires authentication with an access token having the `admin:org` scope.
1
Add organization access to a self-hosted runner group in an enterprise. Use this tool to add an organization to a selected list that can access a self-hosted runner group. The runner group's visibility must be set to 'selected'. Requires an access token with 'manage_runners:enterprise' scope.
1
Add or update a collaborator on a GitHub repository. Use this tool to add a new collaborator or update the permission level of an existing collaborator on a GitHub repository. The invitee will receive a notification, and changes are instantly applied. Be aware of rate limits and permissions restrictions.
1
Add or update a GitHub team's permissions on an organization project. Use this tool to add a project to a GitHub team or update a team's permissions on a project within the same organization. The user must have admin permissions for the project.
1
Add a collaborator to an organization project. This tool adds a collaborator to a specified organization project and assigns a permission level. It requires the user to be an organization owner or a project admin.
1
Add a reaction to a GitHub commit comment. Use this tool to add a reaction (like, love, etc.) to a comment on a GitHub commit. It confirms if the reaction was already added with an HTTP `200` status.
1
Add a reaction to a GitHub issue comment. Use this tool to add a specific reaction to a comment on a GitHub issue. It checks if the reaction type has already been added, returning an HTTP `200` status in that case.
1
Add a reaction to a GitHub issue. Use this tool to add a specific reaction to a GitHub issue. If a reaction has already been added by the user, a response with HTTP status 200 will confirm this. Suitable for managing issue reactions on GitHub repositories.
1
Add a reaction to a GitHub team discussion. Use this tool to add a specific reaction emoji to a team discussion in a GitHub organization. It requires OAuth access tokens with the `write:discussion` scope. This is useful for engaging with team discussions directly through the API.
1
Adds a reaction to a pull request review comment on GitHub. Use this tool to add a reaction to a specific pull request review comment on GitHub. This can be helpful for acknowledging comments or expressing opinions quickly. A successful addition results in an HTTP `200` status.
1
Add a reaction to a GitHub team discussion comment. Use this tool to add a reaction emoji to a specific GitHub team discussion comment within an organization. Useful for engaging with team discussions or acknowledging comments. Requires appropriate OAuth scope.
1
Add repository access to a self-hosted runner group. This tool is used to add a repository to the list of selected repositories that can access a self-hosted runner group within an organization. It should be called when you need to manage repository access for a self-hosted runner group with `selected` visibility. Requires authentication with an `admin:org` scoped access token.
1
Add a repository to a GitHub installation for the authenticated user. Use this tool to add a specific repository to a GitHub installation. The authenticated user must have admin access to the repository. A personal access token is required to authenticate the user.
1
Add a repository to a GitHub organization secret. Use this tool to add a repository to an organization's secret in GitHub when the `visibility` is set to `selected`. Requires an access token with `admin:org` scope or a GitHub App with `dependabot_secrets` permission.
1
Add a repository to an organization's secret. This tool adds a specified repository to an organization secret with 'selected' visibility. It requires authentication with an access token having 'admin:org' scope. GitHub Apps need 'secrets' organization permission.
1
Add a repository to an organization's selected variables. Use this tool to add a repository to a specific organization variable that is available to selected repositories on GitHub. This requires an access token with `admin:org` scope or GitHub App permission `organization_actions_variables:write`. The repository and organization must have the `visibility` field set to `selected`.
1
Adds a repository to a GitHub required workflow. Use this tool to add a repository to a GitHub required workflow. Ensure the workflow is set to run on selected repositories. Authentication with an access token having `admin:org` scope is required.
1
Page 1 of 33(25 of 818)

Selected tools

No tools selected.

Click "Show all tools" to add tools.

Requirements

Select tools to see requirements

#

GithubApi.AcceptGithubRepoInvitation

Accept a GitHub repository invitation. This tool accepts an invitation to join a GitHub repository for the authenticated user. Use it when you need to confirm participation in a repo after receiving an invitation.

Parameters

ParameterTypeReq.Description
invitation_idintegerRequiredThe unique identifier for the GitHub invitation to be accepted.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/accept-invitation-for-authenticated-user'.
#

GithubApi.AddAppAccessRestrictions

Grant specified apps push access to a protected branch. Use this tool to grant specific GitHub Apps push access to protected branches in repositories. Apps must have 'write' access to 'contents' to be authorized. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe repository account owner. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository. This is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
branch_namestringOptionalThe name of the branch to grant push access. Cannot contain wildcard characters. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/add-app-access-restrictions'.
#

GithubApi.AddCustomLabelsToRunner

Add custom labels to a self-hosted runner in an enterprise. Use this tool to attach custom labels to a self-hosted runner within an enterprise on GitHub. Requires authentication with a token that has the `manage_runners:enterprise` scope.

Parameters

ParameterTypeReq.Description
custom_labelsarray<string>RequiredAn array of names for the custom labels to add to the self-hosted runner.
enterprise_identifierstringRequiredThe slug or ID of the enterprise for the self-hosted runner. It identifies the enterprise name or ID in GitHub.
runner_unique_idintegerRequiredThe unique integer identifier for the self-hosted runner.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/add-custom-labels-to-self-hosted-runner-for-enterprise'.
#

GithubApi.AddEmailToGithubAccount

Add a new email to the authenticated GitHub user's account. Use this tool to add an email address to the authenticated GitHub account of the user. This action requires user scope authentication. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/add-email-for-authenticated-user'.
#

GithubApi.AddGithubAuthorizedSshKey

Add an authorized SSH key to GitHub Enterprise. This tool adds an authorized SSH key to a GitHub Enterprise account. It is useful when you want to securely access your GitHub repositories using SSH. Make sure to provide the SSH key in the required format.

Parameters

ParameterTypeReq.Description
public_ssh_keystringRequiredThe public SSH key to add to GitHub Enterprise. Ensure it is in the correct format.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/add-authorized-ssh-key'.
#

GithubApi.AddGithubReleaseReaction

Add a reaction to a GitHub release. Use this tool to create a reaction to a specific release on GitHub. If a reaction already exists, it will return a confirmation with status 200 OK.

Parameters

ParameterTypeReq.Description
reaction_typestringRequiredThe reaction type for the release, e.g., '+1', 'laugh', 'heart'. Choose from '+1', 'laugh', 'heart', 'hooray', 'rocket', 'eyes'.
release_identifierintegerRequiredThe unique identifier for the GitHub release to which the reaction will be added.
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository on GitHub. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/create-for-release'.
#

GithubApi.AddGpgKeyToGithub

Add a GPG key to your authenticated GitHub account. This tool allows you to add a GPG key to your GitHub account after authenticating via Basic Auth or OAuth with the appropriate scope. Use it to enhance security by managing GPG keys on GitHub.

Parameters

ParameterTypeReq.Description
gpg_key_ascii_armored_formatstringRequiredA GPG key in ASCII-armored format to be added to your GitHub account.
new_gpg_key_namestringOptionalA descriptive name for the new GPG key to be added to your GitHub account.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/create-gpg-key-for-authenticated-user'.
#

GithubApi.AddLabelsToGithubIssue

Add labels to a GitHub issue to categorize it. Use this tool to apply one or more labels to a specific issue in a GitHub repository. It helps in categorizing and organizing issues for better project management. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe GitHub account owner of the repository. This value is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the GitHub repository where the issue exists. It is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
issue_numberintegerOptionalThe numeric identifier of the issue to which labels will be added. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/add-labels'.
#

GithubApi.AddLabelsToRunner

Add custom labels to a self-hosted runner in an organization. This tool adds custom labels to a self-hosted GitHub Actions runner configured in an organization. Use this tool when you need to organize or categorize runners with specific labels. Requires authentication with an access token having the `admin:org` scope.

Parameters

ParameterTypeReq.Description
custom_labels_to_addarray<string>RequiredAn array of strings representing the custom labels to add to the self-hosted runner. Each label is a string.
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
runner_idintegerRequiredUnique identifier of the self-hosted runner to which labels are added.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/add-custom-labels-to-self-hosted-runner-for-org'.
#

GithubApi.AddOrgAccessToRunnerGroup

Add organization access to a self-hosted runner group in an enterprise. Use this tool to add an organization to a selected list that can access a self-hosted runner group. The runner group's visibility must be set to 'selected'. Requires an access token with 'manage_runners:enterprise' scope.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID of the enterprise. Use either the enterprise name slug or its ID.
organization_idintegerRequiredThe unique identifier of the organization to add access to the self-hosted runner group.
runner_group_idintegerRequiredUnique identifier for the self-hosted runner group. Required for adding organization access to it.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/add-org-access-to-self-hosted-runner-group-in-enterprise'.
#

GithubApi.AddOrUpdateGithubCollaborator

Add or update a collaborator on a GitHub repository. Use this tool to add a new collaborator or update the permission level of an existing collaborator on a GitHub repository. The invitee will receive a notification, and changes are instantly applied. Be aware of rate limits and permissions restrictions.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user handle for the collaborator to be added or updated.
repository_namestringRequiredThe name of the GitHub repository. This input is not case sensitive.
repository_ownerstringRequiredThe GitHub username of the account owner of the repository. This is not case sensitive.
permission_level_for_github_collaboratorstringOptionalSpecify the permission to grant or update for a collaborator on an organization-owned GitHub repository. Only valid for such repositories.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/add-collaborator'.
#

GithubApi.AddOrUpdateGithubTeamProjectPermissions

Add or update a GitHub team's permissions on an organization project. Use this tool to add a project to a GitHub team or update a team's permissions on a project within the same organization. The user must have admin permissions for the project.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name. This is not case sensitive.
project_idintegerRequiredThe unique identifier of the project to update or add to the team.
team_slugstringRequiredThe slug representation of the GitHub team's name within the organization. This is used to identify the team in the request.
project_permission_levelstringOptionalPermission level to grant the team for the project. Options: 'read', 'write', 'admin'. Default uses the team's current level.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/add-or-update-project-permissions-in-org'.
#

GithubApi.AddProjectCollaborator

Add a collaborator to an organization project. This tool adds a collaborator to a specified organization project and assigns a permission level. It requires the user to be an organization owner or a project admin.

Parameters

ParameterTypeReq.Description
collaborator_usernamestringRequiredThe GitHub username of the collaborator to be added to the project.
project_idintegerRequiredThe unique identifier of the project to which a collaborator is being added. This ID is required to specify the exact project for collaboration.
collaborator_permission_levelstringOptionalThe permission level to assign to the collaborator. Options are: 'read', 'write', or 'admin'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/add-collaborator'.
#

GithubApi.AddReactionToCommitComment

Add a reaction to a GitHub commit comment. Use this tool to add a reaction (like, love, etc.) to a comment on a GitHub commit. It confirms if the reaction was already added with an HTTP `200` status.

Parameters

ParameterTypeReq.Description
comment_idintegerRequiredThe unique identifier of the GitHub commit comment to which the reaction will be added.
reaction_typestringRequiredThe type of reaction to add to the commit comment, e.g., '+1', 'heart', 'laugh'.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe GitHub username of the repository owner. This value is case-insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/create-for-commit-comment'.
#

GithubApi.AddReactionToGithubComment

Add a reaction to a GitHub issue comment. Use this tool to add a specific reaction to a comment on a GitHub issue. It checks if the reaction type has already been added, returning an HTTP `200` status in that case.

Parameters

ParameterTypeReq.Description
comment_unique_identifierintegerRequiredThe unique identifier for the GitHub comment to which a reaction is being added.
reaction_typestringRequiredThe type of reaction to add to the issue comment. Valid options: '+1', '-1', 'laugh', 'confused', 'heart', 'hooray', 'rocket', 'eyes'.
repository_namestringRequiredThe name of the GitHub repository. This name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/create-for-issue-comment'.
#

GithubApi.AddReactionToGithubIssue

Add a reaction to a GitHub issue. Use this tool to add a specific reaction to a GitHub issue. If a reaction has already been added by the user, a response with HTTP status 200 will confirm this. Suitable for managing issue reactions on GitHub repositories.

Parameters

ParameterTypeReq.Description
github_issue_numberintegerRequiredThe number that uniquely identifies the issue on GitHub.
reaction_type_to_addstringRequiredThe reaction type to add to the issue. Options include '+1', '-1', 'laugh', 'confused', 'heart', 'hooray', 'rocket', 'eyes'.
repository_namestringRequiredThe name of the GitHub repository. This is not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/create-for-issue'.
#

GithubApi.AddReactionToGithubTeamDiscussion

Add a reaction to a GitHub team discussion. Use this tool to add a specific reaction emoji to a team discussion in a GitHub organization. It requires OAuth access tokens with the `write:discussion` scope. This is useful for engaging with team discussions directly through the API.

Parameters

ParameterTypeReq.Description
discussion_idintegerRequiredThe unique identifier number for the team discussion.
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
reaction_typestringRequiredThe reaction type to add to the team discussion. Valid options include: '+1', '-1', 'laugh', 'confused', 'heart', 'hooray', 'rocket', 'eyes'.
team_slugstringRequiredThe URL-friendly version of the team's name.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/create-for-team-discussion-in-org'.
#

GithubApi.AddReactionToPrComment

Adds a reaction to a pull request review comment on GitHub. Use this tool to add a reaction to a specific pull request review comment on GitHub. This can be helpful for acknowledging comments or expressing opinions quickly. A successful addition results in an HTTP `200` status.

Parameters

ParameterTypeReq.Description
comment_unique_idintegerRequiredThe unique identifier of the pull request review comment.
reaction_type_for_pr_commentstringRequiredSpecifies the type of reaction to add to the pull request review comment. Valid options are '+1', '-1', 'laugh', 'confused', 'heart', 'hooray', 'rocket', 'eyes'.
repository_namestringRequiredThe name of the repository where the comment is located. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/create-for-pull-request-review-comment'.
#

GithubApi.AddReactionToTeamDiscussionComment

Add a reaction to a GitHub team discussion comment. Use this tool to add a reaction emoji to a specific GitHub team discussion comment within an organization. Useful for engaging with team discussions or acknowledging comments. Requires appropriate OAuth scope.

Parameters

ParameterTypeReq.Description
comment_identifierintegerRequiredThe unique number identifying the team discussion comment to react to.
discussion_identifierintegerRequiredThe number identifying the discussion within the team.
organization_namestringRequiredThe name of the organization. This value is not case sensitive.
reaction_typestringRequiredThe type of reaction emoji to add to the team discussion comment. Accepted values are: '+1', '-1', 'laugh', 'confused', 'heart', 'hooray', 'rocket', 'eyes'.
team_slugstringRequiredThe slug of the team name within the organization, used to identify the team.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/create-for-team-discussion-comment-in-org'.
#

GithubApi.AddRepoAccessToRunnerGroup

Add repository access to a self-hosted runner group. This tool is used to add a repository to the list of selected repositories that can access a self-hosted runner group within an organization. It should be called when you need to manage repository access for a self-hosted runner group with `selected` visibility. Requires authentication with an `admin:org` scoped access token.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. It is not case sensitive.
repository_unique_idintegerRequiredThe unique identifier of the repository to add access for.
runner_group_identifierintegerRequiredProvide the unique integer identifier for the self-hosted runner group.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/add-repo-access-to-self-hosted-runner-group-in-org'.
#

GithubApi.AddRepositoryToGithubInstallation

Add a repository to a GitHub installation for the authenticated user. Use this tool to add a specific repository to a GitHub installation. The authenticated user must have admin access to the repository. A personal access token is required to authenticate the user.

Parameters

ParameterTypeReq.Description
installation_idintegerRequiredThe unique identifier of the GitHub installation.
repository_idintegerRequiredProvide the unique integer identifier of the repository to add to the installation.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/add-repo-to-installation-for-authenticated-user'.
#

GithubApi.AddRepositoryToSecret

Add a repository to a GitHub organization secret. Use this tool to add a repository to an organization's secret in GitHub when the `visibility` is set to `selected`. Requires an access token with `admin:org` scope or a GitHub App with `dependabot_secrets` permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
repository_id_for_org_secretintegerRequiredThe ID of the repository to be added to the organization secret. This ID should be an integer.
secret_namestringRequiredThe name of the organization secret to which a repository will be added. This is case-insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/add-selected-repo-to-org-secret'.
#

GithubApi.AddRepoToOrgSecret

Add a repository to an organization's secret. This tool adds a specified repository to an organization secret with 'selected' visibility. It requires authentication with an access token having 'admin:org' scope. GitHub Apps need 'secrets' organization permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe organization's name. It is not case sensitive.
repository_idintegerRequiredThe unique integer ID of the repository to be added to the organization secret. This ID specifies which repository you want to include.
secret_namestringRequiredThe name of the organization secret to which the repository will be added.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/add-selected-repo-to-org-secret'.
#

GithubApi.AddRepoToOrgVariable

Add a repository to an organization's selected variables. Use this tool to add a repository to a specific organization variable that is available to selected repositories on GitHub. This requires an access token with `admin:org` scope or GitHub App permission `organization_actions_variables:write`. The repository and organization must have the `visibility` field set to `selected`.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. This is not case sensitive.
repository_idintegerRequiredThe integer ID of the repository to be added to the organization variable. This is a required field.
variable_namestringRequiredThe name of the organization variable to which the repository will be added.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/add-selected-repo-to-org-variable'.
#

GithubApi.AddRepoToRequiredWorkflow

Adds a repository to a GitHub required workflow. Use this tool to add a repository to a GitHub required workflow. Ensure the workflow is set to run on selected repositories. Authentication with an access token having `admin:org` scope is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe organization name for GitHub. It is not case sensitive.
repository_unique_identifierintegerRequiredThe unique identifier for the GitHub repository to be added to the required workflow.
required_workflow_identifierintegerRequiredThe unique integer ID of the required workflow to which the repository will be added.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/add-selected-repo-to-required-workflow'.
#

GithubApi.AddRunnerToGroup

Add a self-hosted runner to an organization's runner group. Use this tool to add a self-hosted runner to a specific runner group within an organization on GitHub. Ensure you authenticate with an access token that has the `admin:org` scope to perform this operation.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
runner_group_identifierintegerRequiredThe unique integer identifier of the self-hosted runner group to which the runner will be added.
runner_identifierintegerRequiredUnique identifier of the self-hosted runner to be added to the group.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/add-self-hosted-runner-to-group-for-org'.
#

GithubApi.AddSecurityManagerTeam

Add a team as a security manager for an organization. Use this tool to designate a specific team as the security manager for a GitHub organization. Requires organization admin rights and a token with `write:org` scope. Useful for managing security roles within an organization.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. This is not case sensitive. Required for adding a team as a security manager.
team_slugstringRequiredThe slug of the team name to be added as a security manager. This is case-insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/add-security-manager-team'.
#

GithubApi.AddSelfHostedRunnerToGroup

Add a self-hosted runner to an enterprise group in GitHub. Use this tool to add a self-hosted runner to a specified runner group within an enterprise on GitHub. Authentication with an access token having the 'manage_runners:enterprise' scope is required.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredSlug version or ID of the enterprise for adding the runner.
runner_group_identifierintegerRequiredUnique identifier of the self-hosted runner group.
self_hosted_runner_idintegerRequiredUnique identifier of the self-hosted runner to be added to the group.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/add-self-hosted-runner-to-group-for-enterprise'.
#

GithubApi.AddSshKeyToGithubAccount

Add a public SSH key to your GitHub account. Use this tool to add a public SSH key to the authenticated user's GitHub account, enabling SSH access. Authentication is required via Basic Auth or OAuth with the appropriate scope.

Parameters

ParameterTypeReq.Description
public_ssh_keystringRequiredThe public SSH key content to add to your GitHub account. Ensure it is in the correct format.
ssh_key_titlestringOptionalA descriptive name for the new SSH key added to the GitHub account.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/create-public-ssh-key-for-authenticated-user'.
#

GithubApi.AddStatusCheckContextsToBranch

Add status check contexts to a protected branch. This tool allows users to add status check contexts to a specified protected branch in a GitHub repository. It should be called when managing branch protection rules and ensuring specific contexts are required for status checks. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository to add status check contexts to. This is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
branch_namestringOptionalThe name of the branch to add status check contexts to. Cannot contain wildcard characters. Use GraphQL API for wildcards. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/add-status-check-contexts'.
#

GithubApi.AddTeamAccessToBranch

Grant push access to teams for a specific branch. Use this tool to grant specified teams push access to a protected branch within a repository. Applicable to repositories on GitHub Free, Pro, Team, and Enterprise plans. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository. It is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
branch_namestringOptionalSpecify the branch name to grant team access. Wildcard characters are not allowed. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/add-team-access-restrictions'.
#

GithubApi.AddUpdateGithubTeamMembership

Add or update a user's membership in a GitHub team. This tool adds a member to a GitHub organization's team or updates their role if they are already a member. It is used by authenticated organization owners or team maintainers. If the person isn't part of the organization, an invitation is sent, and their membership will be pending until accepted.

Parameters

ParameterTypeReq.Description
github_team_slugstringRequiredThe slug identifier of the team's name within the organization. This is not case-sensitive.
github_user_handlestringRequiredThe GitHub user account handle to add or update in the organization team.
organization_namestringRequiredThe name of the GitHub organization (case insensitive) to which the team belongs.
user_team_rolestringOptionalSpecifies the role for the user in the team, either 'member' or 'maintainer'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/add-or-update-membership-for-user-in-org'.
#

GithubApi.ApproveOrRejectPendingDeployments

Approve or reject pending deployments for a workflow run. This tool approves or rejects pending deployments that are awaiting a required reviewer's decision. It requires access to repository contents and deployments, and authentication using a token with `repo` scope.

Parameters

ParameterTypeReq.Description
deployment_review_commentstringRequiredA comment to accompany the approval or rejection of the deployment review.
deployment_review_statestringRequiredSpecify 'approved' to approve or 'rejected' to reject deployments to the environments.
environment_idsarray<integer>RequiredList of environment IDs to approve or reject. Each ID must be an integer.
repository_namestringRequiredThe name of the repository. This value is not case-sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
workflow_run_idintegerRequiredThe unique identifier of the workflow run to be approved or rejected.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/review-pending-deployments-for-run'.
#

GithubApi.AssignGithubIssue

Assign users to a GitHub issue. Use this tool to assign up to 10 users to a GitHub issue without replacing existing assignees.

Parameters

ParameterTypeReq.Description
issue_numberintegerRequiredThe number that identifies the GitHub issue to which assignees will be added.
repository_namestringRequiredThe name of the repository. This field is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
assignee_usernamesarray<string>OptionalUsernames of people to assign to the issue. Only users with push access can be assigned.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/add-assignees'.
#

GithubApi.CancelGithubWorkflowRun

Cancels a GitHub workflow run using its ID. Use this tool to cancel an ongoing GitHub Actions workflow run. Authentication with an access token having `repo` scope is required. Useful for stopping workflows that may be executing erroneously or need interruption.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This is not case sensitive and should match the repository where the workflow run is located.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
workflow_run_idintegerRequiredThe unique identifier of the GitHub workflow run to be canceled. This should be an integer value.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/cancel-workflow-run'.
#

GithubApi.CheckBranchCommitSignatureStatus

Check if a branch requires signed commits for protection. Use this tool to determine if a branch in a GitHub repository requires signed commits. This is relevant for repositories with branch protection enabled. Appropriate permissions are needed to access this information.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe name of the branch to check. It cannot contain wildcard characters.
repository_namestringRequiredThe name of the GitHub repository. This is not case sensitive.
repository_ownerstringRequiredThe username of the repository owner. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-commit-signature-protection'.
#

GithubApi.CheckCommitSignatureVerification

Fetches verification status of a commit's signature on GitHub. Use this tool to check whether a commit's signature in a GitHub repository is verified. It provides details about the verification status, including whether it's verified, the reason for the status, and details about the signature and payload. Call this tool when you need to verify the authenticity of a commit.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository to verify the commit signature. Not case-sensitive.
repository_ownerstringRequiredThe account owner of the repository. This value is not case sensitive.
commit_author_filterstringOptionalGitHub login or email address to filter commits by author.
commit_file_path_filterstringOptionalSpecify a file path to filter commits that only include changes to this path.
only_commits_before_datestringOptionalFilter commits to only include those before this date, formatted as `YYYY-MM-DDTHH:MM:SSZ`.
results_page_numberintegerOptionalPage number of the results to fetch, used for pagination.
results_per_pageintegerOptionalSpecifies the number of commits to return per page, up to a maximum of 100.
start_commit_sha_or_branchstringOptionalSHA or branch to start listing commits from. Defaults to the repository's default branch, usually 'main'.
updated_after_timestampstringOptionalTimestamp in ISO 8601 format to filter notifications updated after this time.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-commits'.
#

GithubApi.CheckConfigStatus

Check the status of the most recent configuration process. Use this tool to determine whether the latest configuration process is pending, configuring, done, or failed. It may take several seconds after starting the process to check its status.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-configuration-status'.
#

GithubApi.CheckGithubOrgMembership

Checks if a user is a public member of a GitHub organization. Use this tool to determine if a specific user is publicly a member of a particular GitHub organization. This can be useful for confirming a user's affiliation with an organization.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user account handle to check for public organization membership.
organization_namestringRequiredThe case-insensitive name of the GitHub organization.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/check-public-membership-for-user'.
#

GithubApi.CheckGithubRepoCollaborator

Check if a user is a collaborator on a GitHub repository. This tool checks if a specific user is a collaborator on a GitHub repository, including outside collaborators, organization members with direct or team access, and organization owners. It requires authentication with appropriate permissions.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub username to check collaboration status for.
repository_namestringRequiredThe name of the GitHub repository, case-insensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository, not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/check-collaborator'.
#

GithubApi.CheckGithubTokenValidity

Check GitHub OAuth token validity with reduced rate limits.

Parameters

ParameterTypeReq.Description
github_app_client_idstringRequiredThe unique client ID of the GitHub application for OAuth authentication.
oauth_access_tokenstringRequiredThe OAuth access token to verify its validity with the GitHub API.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/check-token'.
#

GithubApi.CheckIfGistIsStarred

Determine if a specific gist is starred on GitHub. This tool checks the starred status of a specific GitHub gist using its gist ID.

Parameters

ParameterTypeReq.Description
gist_identifierstringRequiredThe unique identifier for the gist to check if it is starred.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/check-is-starred'.
#

GithubApi.CheckIfUserIsFollowed

Check if a user is followed by the authenticated GitHub user. Use this tool to verify if the authenticated GitHub user is following another specified user. It determines the follow status between the authenticated user and the target user.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe handle for the GitHub user account to check if they are followed by the authenticated user.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/check-person-is-followed-by-authenticated'.
#

GithubApi.CheckMaintenanceStatus

Retrieve the maintenance status of your GitHub installation. Use this tool to check the maintenance status of your GitHub installation. It's useful for determining if the installation is currently under maintenance.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-maintenance-status'.
#

GithubApi.CheckOrgMigrationStatus

Fetches the status of an organization's migration. This tool retrieves the current status of a specific migration for an organization on GitHub. The migration status can be 'pending', 'exporting', 'exported', or 'failed'. Use this tool to monitor migration progress or verify completion.

Parameters

ParameterTypeReq.Description
migration_idintegerRequiredThe unique identifier of the migration. Expected as an integer.
organization_namestringRequiredThe name of the organization, not case sensitive, for which to fetch migration status.
exclude_attributesarray<string>OptionalList of attribute names to exclude from the API response for improved performance.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'migrations/get-status-for-org'.
#

GithubApi.CheckPrMergeStatus

Check if a pull request has been merged. Use this tool to determine if a specific pull request in a GitHub repository has been merged. This is useful for tracking development progress and managing project contributions.

Parameters

ParameterTypeReq.Description
pull_request_numberintegerRequiredThe unique number identifying the specific pull request to check.
repository_namestringRequiredThe name of the repository. Input is case insensitive.
repository_ownerstringRequiredThe account owner of the repository. This value is not case sensitive. It specifies which user's or organization's repository contains the pull request.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/check-if-merged'.
#

GithubApi.CheckRepoCollaboratorPermission

Check a collaborator's permission level in a GitHub repo. Use this tool to find out if a collaborator has `admin`, `write`, `read`, or `none` permissions in a specific GitHub repository.

Parameters

ParameterTypeReq.Description
collaborator_usernamestringRequiredThe GitHub user account handle to check permissions for.
repository_namestringRequiredThe name of the GitHub repository (case insensitive).
repository_ownerstringRequiredThe account owner of the repository (not case sensitive).

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-collaborator-permission-level'.
#

GithubApi.CheckRepoStarredByUser

Check if a repository is starred by the authenticated user. This tool verifies whether the authenticated user has starred a specific GitHub repository, identified by its owner and repository name.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository to check. This is case insensitive.
repository_owner_accountstringRequiredThe account owner of the repository. This value is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/check-repo-is-starred-by-authenticated-user'.
#

GithubApi.CheckTeamProjectPermissions

Check team's permissions for an organization's project. Use this tool to determine if a team has `read`, `write`, or `admin` permissions for a specific project within an organization. This includes projects inherited from a parent team.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. It is not case sensitive.
project_unique_identifierintegerRequiredThe unique integer ID of the project to check permissions for.
team_slugstringRequiredThe slug of the team name used to identify the team within the organization. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/check-permissions-for-project-in-org'.
#

GithubApi.CheckTeamRepoPermissions

Check a team's permissions for a specific repository within an organization. This tool verifies whether a team has specific permissions (admin, push, maintain, triage, or pull) for a given repository within an organization on GitHub. It can be used to ensure access rights are correctly configured. If the team lacks permissions, a 404 response indicates no access.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe organization name on GitHub. It is not case sensitive. Required to check team permissions.
repository_namestringRequiredThe name of the repository for which you want to check permissions. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository, not case sensitive.
team_slugstringRequiredThe slug of the team name. Used to identify the team whose permissions you are checking.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/check-permissions-for-repo-in-org'.
#

GithubApi.CheckThreadSubscription

Check if the authenticated user is subscribed to a thread. This tool determines if the current user is subscribed to a specific thread on GitHub. Subscriptions are present if the user is participating in the conversation, such as replying, being @mentioned, or manually subscribing to the thread.

Parameters

ParameterTypeReq.Description
notification_thread_idintegerRequiredThe unique identifier of the notification thread, retrieved from notification data.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/get-thread-subscription-for-authenticated-user'.
#

GithubApi.CheckUserAssignmentPermission

Check if a user can be assigned to a GitHub issue. This tool checks if a specified user has permission to be assigned to an issue within a given GitHub repository. It should be called when you need to verify a user's eligibility to be an assignee for issues in a repository.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. Input is not case sensitive.
user_assigneestringRequiredThe username of the GitHub user to check for issue assignment permissions.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/check-user-can-be-assigned'.
#

GithubApi.CheckUserAssignPermission

Check if a user can be assigned to a GitHub issue. Use this tool to verify if a specific user can be assigned as an assignee to a particular issue in a GitHub repository. A 204 status indicates permission, while a 404 indicates the user cannot be assigned.

Parameters

ParameterTypeReq.Description
assignee_usernamestringRequiredThe GitHub username of the person to check for assignment permission.
issue_identifierintegerRequiredThe number that identifies the specific issue in the repository.
repository_namestringRequiredThe name of the repository, not case sensitive, where the issue is located.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/check-user-can-be-assigned-to-issue'.
#

GithubApi.CheckUserFollowingStatus

Verify if a user follows another GitHub user. This tool checks if one GitHub user follows another. Use it to determine follow relationships between two users on GitHub.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe handle for the GitHub user account initiating the following request.
target_usernamestringRequiredThe username of the GitHub account you want to check if the main user follows.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/check-following-for-user'.
#

GithubApi.CheckUserMembershipInOrg

Checks if a user is a member of a GitHub organization. This tool determines whether a specified user is a member of a specified GitHub organization, either publicly or privately. Use this tool to verify membership status in organizational repositories or workflows.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe username or handle for the GitHub user account being checked for organization membership.
organization_namestringRequiredThe case-insensitive name of the GitHub organization to check membership against.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/check-membership-for-user'.
#

GithubApi.CompareDependencyChanges

Get dependency changes between two commits of a repository. Use this tool to retrieve a diff of dependency changes based on updates to dependency manifests between two specified commits in a GitHub repository. It is useful for understanding what dependencies have been added, removed, or updated.

Parameters

ParameterTypeReq.Description
base_and_head_commit_specificationstringRequiredSpecify the base and head commits in the format `{base}...{head}` for comparison.
repository_namestringRequiredThe name of the repository to compare. It is not case sensitive.
repository_owner_namestringRequiredThe account owner of the repository. The name is not case sensitive.
dependency_manifest_file_pathstringOptionalThe full path, relative to the repository root, of the dependency manifest file.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependency-graph/diff-range'.
#

GithubApi.CompareGithubCommits

Compares two commits in a GitHub repository. Use this tool to compare two commits in a GitHub repository, including those in different branches or forks. Returns details about file changes, commit order, and signature verification status. Useful for understanding code changes and repository history.

Parameters

ParameterTypeReq.Description
base_and_head_branch_comparisonstringRequiredSpecify branches/base and head in the format `BASE...HEAD` or `USERNAME:BASE...USERNAME:HEAD` to compare them.
repository_namestringRequiredThe name of the GitHub repository to compare commits in. This input is not case sensitive.
repository_ownerstringRequiredThe username of the account that owns the repository. This name is not case sensitive.
page_numberintegerOptionalPage number of the results to fetch. Used for pagination to navigate through commit comparisons.
results_per_pageintegerOptionalSpecifies the number of commit results returned per page. Maximum allowed is 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/compare-commits'.
#

GithubApi.CompleteGithubAppHandshake

Complete the GitHub App Manifest handshake to retrieve app details. Use this tool to finalize the creation of a GitHub App via the manifest flow, retrieving the app's id, pem (private key), and webhook_secret using a temporary code.

Parameters

ParameterTypeReq.Description
temporary_code_for_github_appstringRequiredThe temporary code provided during the GitHub App Manifest flow to retrieve the app's id, pem, and webhook_secret.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/create-from-manifest'.
#

GithubApi.ConfigureGithubActionsCache

Set GitHub Actions cache usage policy for a repository. Use this tool to configure the cache usage policy for GitHub Actions in a repository. Authentication with an access token with 'repo' scope is required, or GitHub Apps need 'actions:write' permission.

Parameters

ParameterTypeReq.Description
repository_cache_size_limit_gbintegerRequiredSpecify the size limit for all GitHub Actions caches in the repository, in gigabytes.
repository_namestringRequiredThe name of the GitHub repository. This field is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is the GitHub username or organization name and is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-actions-cache-usage-policy'.
#

GithubApi.ConfigureGithubActionsPermissions

Configure GitHub Actions permissions for an organization. Use this tool to set the GitHub Actions permissions policy for repositories and allowed actions within an organization. Note that enterprise-level restrictions cannot be overridden. Requires authentication with an 'admin:org' token or 'administration' organization permission for GitHub Apps.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
repository_execution_policystringRequiredSpecifies which repositories in the organization are allowed to run GitHub Actions. Options: 'all', 'none', 'selected'.
allowed_actions_policystringOptionalSpecifies the permissions policy for actions: 'all', 'local_only', or 'selected'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-github-actions-permissions-organization'.
#

GithubApi.ConfigureGithubPagesSite

Configures a GitHub Pages site for a repository. This tool is used to configure a Pages site for a GitHub repository on an Enterprise Server. It requires administrative permissions on the repository and a token with appropriate scopes. Use this when you need to set up or manage a GitHub Pages site. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. This is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository to configure. It is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-pages-site'.
#

GithubApi.ConfigureGithubTokenPermissions

Set default workflow permissions for a repository's GitHub Actions. This tool updates the default permissions granted to the `GITHUB_TOKEN` when workflows run in a GitHub repository. It also configures GitHub Actions' ability to submit approving pull request reviews. Authentication with a token having `repo` scope is required, or GitHub Apps must have `administration` permission.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is not case sensitive.
default_workflow_permissionsstringOptionalSpecify the default permissions ('read' or 'write') for the GITHUB_TOKEN when running workflows.
enable_pull_request_approvalbooleanOptionalSet to true to allow GitHub Actions to approve pull requests. Enabling this may pose a security risk.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-github-actions-default-workflow-permissions-repository'.
#

GithubApi.ConvertMemberToOutsideCollaborator

Convert GitHub org member to outside collaborator. Use this tool to convert an organization member into an outside collaborator on GitHub. The member will lose their organization membership and retain access only to repositories allowed by their team memberships. This action might be restricted by enterprise policies.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user handle to be converted to an outside collaborator.
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
perform_asynchronouslybooleanOptionalSet to true to perform the request asynchronously, queuing the job with a 202 status code.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/convert-member-to-outside-collaborator'.
#

GithubApi.CreateEnterpriseScimGroup

Create a SCIM group for a GitHub enterprise account. Facilitates the creation of a SCIM group within a GitHub enterprise. This tool should be used when you need to establish a new group with optional member inclusion. Any specified members will be added as external group members, and it's important to maintain mapping of their identifiers. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/provision-enterprise-group'.
#

GithubApi.CreateEnterpriseUser

Creates a new user in GitHub enterprise with external authentication. This tool should be called to create a new user in GitHub Enterprise when using external authentication mechanisms like LDAP. It ensures the login name is normalized and manages existing account conflicts.

Parameters

ParameterTypeReq.Description
user_usernamestringRequiredThe user's username for the GitHub enterprise account. It will be normalized to contain only alphanumeric characters or single hyphens.
user_emailstringOptionalThe email address of the user. Required for built-in authentication but optional for CAS, LDAP, or SAML auth methods.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/create-user'.
#

GithubApi.CreateGist

Create a new gist with one or more files on GitHub. Use this tool to add a new gist containing one or more code files on GitHub. Avoid naming files with the 'gistfile' format followed by a number, as it may conflict with GitHub's internal naming scheme. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/create'.
#

GithubApi.CreateGistComment

Create a comment on a GitHub gist. This tool is used to add a comment to a specific GitHub gist by providing the necessary gist ID and comment content.

Parameters

ParameterTypeReq.Description
comment_textstringRequiredThe text content of the comment to be added to the gist.
gist_unique_identifierstringRequiredThe unique identifier of the gist to comment on.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/create-comment'.
#

GithubApi.CreateGitCommit

Create a new Git commit on a GitHub repository. This tool creates a new Git commit on a specified GitHub repository and verifies the commit's signature. It returns information about the verification status, including whether it's verified and the reason, if applicable. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. This name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the GitHub repository (case insensitive). Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'git/create-commit'.
#

GithubApi.CreateGithubAppInstallationToken

Create an installation access token for a GitHub App. Use this tool to generate an installation access token for a GitHub App, allowing it to make authenticated API requests for its installation on an organization or individual account. Tokens expire in one hour and can be restricted to specific repositories by providing `repository_ids`. Requires JWT authentication. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
installation_idintegerOptionalThe unique identifier for the GitHub App installation. Required to create the access token. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/create-installation-access-token'.
#

GithubApi.CreateGithubBlob

Create a new blob in a GitHub repository. This tool creates a new blob object in a specified GitHub repository. It is useful when you need to add or modify a blob within the repository, typically for storing binary data or files.

Parameters

ParameterTypeReq.Description
blob_contentstringRequiredThe content for the new GitHub blob. Accepts text or encoded binary data.
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. This is not case sensitive.
content_encodingstringOptionalSpecify the encoding for the blob content. Supported values are 'utf-8' and 'base64'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'git/create-blob'.
#

GithubApi.CreateGithubCheckRun

Create a new check run for a GitHub repository commit. This tool creates a new check run associated with a specific commit in a GitHub repository. It requires the 'checks:write' permission in the GitHub App. Note that this tool is sensitive to the branch it's applied to, as it only processes pushes in the repository where it's created, not in forked repositories. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository. It is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'checks/create'.
#

GithubApi.CreateGithubCheckSuite

Manually create a check suite on GitHub. Use this tool to manually create a check suite in a GitHub repository when automatic creation is disabled. Ensure your GitHub App has the `checks:write` permission before using this endpoint.

Parameters

ParameterTypeReq.Description
head_commit_shastringRequiredThe SHA of the head commit for the check suite. Ensure it's a valid commit SHA.
repository_namestringRequiredThe name of the GitHub repository where the check suite will be created. It is not case sensitive.
repository_owner_accountstringRequiredSpecify the account owner of the repository. This name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'checks/create-suite'.
#

GithubApi.CreateGithubCommitComment

Create a comment on a specific GitHub commit. Use this tool to add a comment to a specific commit on a GitHub repository using the commit's SHA identifier. Useful for discussing changes directly within the commit history. Be mindful of rate limiting when using this endpoint.

Parameters

ParameterTypeReq.Description
comment_contentstringRequiredThe text of the comment to be added to the commit. It should be a clear and concise message.
commit_shastringRequiredThe SHA identifier of the commit to comment on. It uniquely identifies the commit within the repository.
repository_namestringRequiredThe name of the GitHub repository where the commit resides. It's not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. Name is not case sensitive.
deprecated_line_numberintegerOptionalLine number in the file to comment on. **Deprecated**. Use the `position_in_diff` instead.
line_index_in_diffintegerOptionalLine index in the diff to comment on.
relative_file_pathstringOptionalRelative path of the file to comment on within the repository.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-commit-comment'.
#

GithubApi.CreateGithubCommitStatus

Create a commit status for a specific SHA on GitHub. Use this tool to set a commit status for a specific SHA in a GitHub repository if you have push access. Useful for marking build status, testing results, or other commit contexts. Be mindful of the 1000 status limit per SHA and context.

Parameters

ParameterTypeReq.Description
commit_shastringRequiredThe SHA hash of the commit to set the status for. This uniquely identifies the commit in the repository.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Enter the owner's username (not case sensitive).
status_statestringRequiredThe state of the status for the commit. Possible values are 'error', 'failure', 'pending', or 'success'.
commit_status_target_urlstringOptionalThe URL associated with the status for easy navigation in GitHub. Example: a deep link to CI build output.
status_descriptionstringOptionalA short description of the commit status, providing context or details about the status.
status_labelstringOptionalA case-insensitive string label to differentiate this status from other systems.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-commit-status'.
#

GithubApi.CreateGithubDeployKey

Create a read-only deploy key for a GitHub repository. Use this tool to generate a read-only deploy key for a specified GitHub repository. Ideal for automating and securing repository access.

Parameters

ParameterTypeReq.Description
deploy_key_contentsstringRequiredThe public key contents to be added as a deploy key.
repository_namestringRequiredThe case-insensitive name of the GitHub repository.
repository_ownerstringRequiredThe account owner of the GitHub repository. Name is not case sensitive.
key_titlestringOptionalA name for the deploy key for identification purposes.
read_only_accessbooleanOptionalSet to `true` for read-only access. `False` allows both read and write access.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-deploy-key'.
#

GithubApi.CreateGithubDeployment

Create a GitHub deployment for a specified repository ref. Use this tool to create deployments for a specific branch, tag, or SHA in a GitHub repository. Configure parameters like environment, auto-merge, and required contexts. Suitable for deploying to production, staging, or testing environments. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. This input is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository to deploy. Not case-sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-deployment'.
#

GithubApi.CreateGithubDeploymentBranchPolicy

Creates a deployment branch policy for a GitHub environment. This tool is used to create a deployment branch policy within a specified environment on GitHub. It requires authentication with a valid access token with the 'repo' scope or a GitHub App with 'administration:write' permission for the repository.

Parameters

ParameterTypeReq.Description
branch_name_patternstringRequiredA pattern that branches must match to deploy to the environment. Wildcard characters won't match '/'.
environment_namestringRequiredThe name of the environment for which to create a deployment branch policy.
repository_namestringRequiredThe name of the GitHub repository, not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-deployment-branch-policy'.
#

GithubApi.CreateGithubDeploymentStatus

Create deployment statuses for a GitHub deployment. This tool allows users with appropriate permissions to create deployment statuses on GitHub for a specific deployment. It requires push access for users, and specific access scopes for GitHub and OAuth Apps. Use this tool to update the status of your deployments directly within GitHub repositories.

Parameters

ParameterTypeReq.Description
deployment_idintegerRequiredThe unique identifier for the deployment. This integer value specifies which deployment the status will be associated with.
deployment_status_statestringRequiredThe desired state of the deployment status. Options include: 'error', 'failure', 'inactive', 'in_progress', 'queued', 'pending', 'success'.
repository_namestringRequiredThe name of the GitHub repository. Case insensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
add_inactive_status_to_previous_deploymentsbooleanOptionalSpecifies if an 'inactive' status should be added to prior non-transient, non-production deployments with the same repository and environment. Defaults to true.
deployment_environmentstringOptionalSpecifies the target deployment environment, such as `production`, `staging`, or `qa`.
deployment_environment_urlstringOptionalSets the URL for accessing your deployment environment. Defaults to an empty string if not provided.
deployment_output_urlstringOptionalThe full URL of the deployment's output. It replaces `target_url` and automatically sets `target_url` to the same value. Recommended for output logs.
deployment_status_target_urlstringOptionalSpecify the URL containing output related to the deployment status. Note that it's recommended to use `log_url` instead, which replaces this parameter.
status_descriptionstringOptionalA brief description of the deployment status, up to 140 characters.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-deployment-status'.
#

GithubApi.CreateGithubEnterpriseRegistrationToken

Generate a registration token for GitHub Enterprise runners. Use this tool to obtain a registration token for configuring self-hosted GitHub Enterprise runners. The token expires after one hour and requires authentication with a token having the `manage_runners:enterprise` scope.

Parameters

ParameterTypeReq.Description
enterprise_slug_or_idstringRequiredThe slug version of the enterprise name or the enterprise ID for GitHub Enterprise.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/create-registration-token-for-enterprise'.
#

GithubApi.CreateGithubEnvVariable

Create an environment variable for GitHub Actions workflows. This tool creates an environment variable that can be referenced in a GitHub Actions workflow. Authentication with an access token and appropriate permissions is required.

Parameters

ParameterTypeReq.Description
environment_namestringRequiredSpecify the name of the environment where the variable will be created. This is required for defining the scope within GitHub Actions workflows.
repository_identifierintegerRequiredThe unique identifier of the repository for which the environment variable is being created.
variable_namestringRequiredThe name of the environment variable to be created.
variable_valuestringRequiredThe value assigned to the environment variable. Must be a string.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/create-environment-variable'.
#

GithubApi.CreateGithubFork

Create a fork of a GitHub repository for the user. Create a fork of a GitHub repository for the authenticated user. Note that the forking process happens asynchronously and might take some time. Contact GitHub support if it takes longer than 5 minutes.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository to fork. It's not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. This name is not case-sensitive.
fork_default_branch_onlybooleanOptionalSet to true to fork only the default branch of the repository.
new_fork_namestringOptionalSpecify a new name for the forked repository when forking an existing repository.
organization_namestringOptionalOptional. Specify the organization name to fork into. If not provided, the fork will default to the user's account.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-fork'.
#

GithubApi.CreateGithubIssue

Create a new issue in a GitHub repository. Use this tool to create a new issue in a specific GitHub repository. This can be done by any user with pull access to the repository. Note that if issues are disabled for the repository, a 410 status will be returned. Be cautious of triggering secondary rate limits by creating content too quickly. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the GitHub repository. Provide the username or organization name, case insensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the GitHub repository. Case insensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/create'.
#

GithubApi.CreateGithubLabel

Creates a label in a specified GitHub repository. Use this tool to add a new label to a GitHub repository, which can help categorize and manage issues effectively.

Parameters

ParameterTypeReq.Description
label_namestringRequiredThe name of the label, supporting emojis using either native emoji or colon-style markup.
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. Case insensitive.
label_color_hexstringOptionalThe hexadecimal color code for the label, without the leading '#'.
label_descriptionstringOptionalA short description of the label, with a maximum of 100 characters.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/create-label'.
#

GithubApi.CreateGithubMilestone

Create a milestone in a GitHub repository. Use this tool to create a new milestone in a specified GitHub repository, useful for project management and tracking.

Parameters

ParameterTypeReq.Description
milestone_titlestringRequiredThe title of the milestone to be created in the GitHub repository.
repository_namestringRequiredThe name of the repository, not case sensitive.
repository_ownerstringRequiredThe GitHub username or organization name that owns the repository. Not case sensitive.
milestone_descriptionstringOptionalA text description of the milestone to be created in the GitHub repository.
milestone_due_datestringOptionalThe due date for the milestone in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.
milestone_statestringOptionalState of the milestone, either 'open' or 'closed'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/create-milestone'.
#

GithubApi.CreateGithubOrganization

Create a new organization on GitHub. This tool is used to create a new organization on GitHub Enterprise. Call it when you need to set up a new organization within a GitHub Enterprise setup.

Parameters

ParameterTypeReq.Description
admin_user_loginstringRequiredThe login username of the user designated to manage the new GitHub organization.
organization_usernamestringRequiredThe username for the organization in GitHub.
organization_display_namestringOptionalThe display name for the organization to be created on GitHub.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/create-org'.
#

GithubApi.CreateGithubOrganizationRepo

Create a new repository in a GitHub organization. Use this tool to create a new repository within a specified GitHub organization. The user must have appropriate OAuth scopes and be a member of the organization. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
organization_namestringOptionalThe name of the GitHub organization where the repository will be created. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-in-org'.
#

GithubApi.CreateGithubOrgVariable

Create an organization variable for GitHub Actions workflows. Creates an organization variable in GitHub that can be referenced in Actions workflows. Requires an access token with `admin:org` scope or `organization_actions_variables:write` permission for GitHub Apps.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. It is not case sensitive.
repository_access_visibilitystringRequiredType of repositories in the organization that can access the variable: 'all', 'private', or 'selected'.
variable_namestringRequiredThe name of the organization variable to be created. This name will be used to reference the variable in workflows.
variable_valuestringRequiredThe value assigned to the organization variable in GitHub.
repository_ids_with_variable_accessarray<integer>OptionalList of repository IDs allowed to access the organization variable. Required when 'visibility' is 'selected'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/create-org-variable'.
#

GithubApi.CreateGithubOrgWebhook

Create a webhook for a GitHub organization. This tool is used to set up a webhook for a GitHub organization to post payloads in JSON format. Call this tool when you need to automate notifications or integrate with other services based on GitHub events. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
organization_namestringOptionalThe name of the GitHub organization. This value is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/create-webhook'.
#

GithubApi.CreateGithubPagesDeployment

Create a GitHub Pages deployment for a repository. Use this tool to deploy a GitHub Pages site for a repository. Requires write permissions or `pages:write` permission for GitHub Apps.

Parameters

ParameterTypeReq.Description
artifact_urlstringRequiredURL of the artifact (.zip or .tar) with static assets for deployment. Must belong to the repository.
oidc_token_for_deploymentstringRequiredThe OIDC token from GitHub Actions used to certify the deployment origin.
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is not case sensitive.
build_version_identifierstringOptionalA unique string representing the version of the deployment build.
target_environment_for_deploymentstringOptionalSpecify the target environment for the GitHub Pages deployment (e.g., 'production', 'staging').

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-pages-deployment'.
#

GithubApi.CreateGithubProjectBoard

Create a project board for a GitHub repository. This tool creates a project board for a specified GitHub repository. It's useful when you want to organize tasks or issues in the form of a project board within a repository. It returns information about the creation status and any errors due to disabled projects or insufficient privileges.

Parameters

ParameterTypeReq.Description
project_namestringRequiredThe name of the project board to be created in the repository.
repository_namestringRequiredThe name of the GitHub repository. It is not case-sensitive.
repository_ownerstringRequiredThe username of the account that owns the repository. This is not case sensitive.
project_descriptionstringOptionalProvide a descriptive text for the project board to help clarify its purpose and content.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/create-for-repo'.
#

GithubApi.CreateGithubProjectCard

Create a project card in a specified GitHub column. Use this tool to create a new project card in a specified column within a GitHub project. It helps organize tasks or notes in a project on GitHub. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
column_identifierintegerOptionalThe unique identifier of the GitHub project column where the card will be added. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/create-card'.
#

GithubApi.CreateGithubPullRequest

Create a draft pull request on GitHub repositories. Use this tool to create a draft pull request on a specified GitHub repository. Requires write access to the head or source branch. Suitable for users with appropriate permissions on public, private or organization-owned repositories.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository for the pull request. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. Case-insensitive.
source_branchstringRequiredThe name of the branch where your changes are implemented. Use `username:branch` format for cross-repository cases.
target_branchstringRequiredThe branch name where changes are to be merged. Must be an existing branch in the current repository.
is_draftbooleanOptionalSet to true to create the pull request as a draft. See GitHub documentation for more on draft pull requests.
issue_number_for_conversionintegerOptionalSpecify the issue number in the repository to convert into a pull request. Required unless a title is provided.
maintainers_can_modifybooleanOptionalIndicates if maintainers can modify the pull request. Set to true to allow modifications.
pull_request_contentstringOptionalThe descriptive content or message for the pull request.
pull_request_titlestringOptionalThe title of the new pull request. This is required unless an `issue` is specified.
source_repository_namestringOptionalName of the repository where changes in the pull request were made. Required for cross-repository pull requests within the same organization.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/create'.
#

GithubApi.CreateGithubPullRequestReview

Create a review for a GitHub pull request. Use this tool to create a review for a specific pull request on GitHub, either in the 'PENDING' state or by submitting it. Ideal for adding comments or feedback on code changes. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository (case-insensitive). Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository where the pull request exists, not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
pull_request_numberintegerOptionalThe number that uniquely identifies the pull request for which the review is being created. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/create-review'.
#

GithubApi.CreateGithubRelease

Creates a new release in a specified GitHub repository. This tool allows users with push access to create a release in a specified GitHub repository. It triggers notifications and may be subject to rate limiting. Use this tool when you need to publish a new version or release of your software on GitHub.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository on GitHub. This name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
tag_name_for_releasestringRequiredThe name of the tag for the release. This is used to label the GitHub release.
auto_generate_release_notesbooleanOptionalAutomatically generate the name and body for the release. If 'name' is provided, it is used; otherwise, a name is auto-generated. 'Body' is prepended to generated notes if specified.
commit_referencestringOptionalThe branch or commit SHA from which the Git tag is created. Defaults to the repo's default branch.
draftbooleanOptionalSet to `true` for a draft (unpublished) release, or `false` for a published one.
mark_as_prereleasebooleanOptionalSet to `true` for a prerelease, `false` for a full release.
release_body_textstringOptionalText describing the contents of the tag. This is the message or notes for the release, providing context or details about changes.
release_namestringOptionalThe name of the release. This identifies the release and can be a version or descriptive text.
set_latest_releasebooleanOptionalSet whether this release should be the latest. Use 'true', 'false', or 'legacy'. Drafts and prereleases cannot be set as latest.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-release'.
#

GithubApi.CreateGithubRepoForUser

Create a new GitHub repository for the authenticated user. This tool creates a new repository for the authenticated user. It requires appropriate OAuth scopes: `public_repo` or `repo` for public repositories, and `repo` for private repositories. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-for-authenticated-user'.
#

GithubApi.CreateGithubRepoVariable

Create a variable for a GitHub repository to use in Actions workflows. Use this tool to create a repository variable that can be referenced in a GitHub Actions workflow. Ensure that you authenticate with a token having the 'repo' scope, or ensure GitHub Apps have 'actions_variables:write' permission.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. This value is not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. Case insensitive.
variable_namestringRequiredThe name of the repository variable to create.
variable_valuestringRequiredThe content or data for the repository variable.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/create-repo-variable'.
#

GithubApi.CreateGithubRepoWebhook

Create a webhook for a GitHub repository. This tool sets up a webhook for a specified GitHub repository, allowing integrations to receive events. Use this when you want to trigger actions in response to repository events. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the GitHub repository. It is case insensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the GitHub repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-webhook'.
#

GithubApi.CreateGithubRequiredWorkflow

Create a required workflow in a GitHub organization. This tool creates a required workflow within a specified GitHub organization. It requires an access token with 'admin:org' scope for authentication. Use this tool when setting up or enforcing organizational workflow standards on GitHub.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
repository_identifierstringRequiredThe ID of the repository that contains the workflow file. Use this to specify which repository's workflow file should be used.
workflow_file_pathstringRequiredPath of the workflow file to set as required for the organization.
repository_ids_for_selected_scopearray<integer>OptionalList of repository IDs to enable the workflow when `scope` is 'selected'.
workflow_scopestringOptionalSpecify whether to enable the required workflow for all repositories or only selected ones within the organization. Use 'all' for all repositories and 'selected' when specifying particular repositories.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/create-required-workflow'.
#

GithubApi.CreateGithubScopedToken

Create a GitHub repository and permission scoped token. This tool generates a repository and/or permission scoped user-to-server access token for GitHub. It requires a non-scoped token and the client's Basic Authentication details. Use this when specific repository access or permission is needed for an app. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
github_client_idstringOptionalThe client ID of your GitHub app used for authentication. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/scope-token'.
#

GithubApi.CreateGithubTeam

Create a new team in a GitHub organization. Use this tool to create a new team within a specified GitHub organization. The authenticated user must be a member or owner of the organization. Upon creation, the user becomes a team maintainer by default.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe case-insensitive name of the GitHub organization where the team will be created.
team_namestringRequiredThe name of the team to be created. It should be a string.
deprecated_repository_permissionstringOptionalSpecifies the permission for new repositories, though it is deprecated. Options are `pull` or `push`.
ldap_distinguished_namestringOptionalThe distinguished name (DN) of the LDAP entry to map to a team. Ensure LDAP synchronization is enabled.
parent_team_idintegerOptionalThe numerical ID of the team to assign as the parent for the new team.
repository_names_to_add_to_teamarray<string>OptionalArray of full repository names (e.g., "organization-name/repository-name") to associate with the team.
team_descriptionstringOptionalA brief description of the team being created. This helps specify the team's purpose or role within the organization.
team_maintainers_github_idsarray<string>OptionalList of GitHub IDs for organization members who will become team maintainers.
team_privacy_levelstringOptionalSpecifies if the team is 'secret' or 'closed'. Defaults: 'secret' for non-nested teams, 'closed' for parent/child teams.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/create'.
#

GithubApi.CreateGithubUserProjectBoard

Create a project board for a GitHub user. This tool creates a project board for an authenticated GitHub user. It returns a `410 Gone` status if the user does not have existing classic projects, or `401 Unauthorized` if privileges are insufficient.

Parameters

ParameterTypeReq.Description
project_namestringRequiredThe name for the GitHub project board to be created. It should be a string representing the desired name.
project_bodystringOptionalThe content or description of the GitHub project board. It should be a concise string summarizing the project's purpose or details.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/create-for-authenticated-user'.
#

GithubApi.CreateGitReference

Create a new reference in a GitHub repository. Use this tool to create a new reference in a GitHub repository, such as a branch or a tag. Ensure the repository is not empty and contains at least one branch.

Parameters

ParameterTypeReq.Description
full_reference_namestringRequiredThe fully qualified reference name (e.g., 'refs/heads/master'). Must start with 'refs' and include at least two slashes.
reference_shastringRequiredThe SHA-1 value for the reference. Required for creating a new reference in the repository.
repository_namestringRequiredThe case-insensitive name of the GitHub repository to create a reference in.
repository_ownerstringRequiredThe account owner of the repository, not case sensitive.
authentication_tokenstringOptionalThe GitHub authentication token required to authorize the API request.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'git/create-ref'.
#

GithubApi.CreateGitTag

Create a Git tag object on GitHub. Use this tool to create a Git tag object on GitHub. Note that this does not automatically create the reference to make a tag in the repository; an additional call is required to create the reference. The response includes a verification object with details on the commit's signature verification, providing insights into if and why a signature was verified, or any issues that occurred.

Parameters

ParameterTypeReq.Description
git_object_shastringRequiredThe SHA of the Git object to tag, typically a commit, tree, or blob.
repository_namestringRequiredThe name of the repository. This value is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
tag_messagestringRequiredThe message or description for the tag, providing context or details about it.
tag_namestringRequiredThe name of the tag, typically a version (e.g., 'v0.0.1').
tag_object_typestringRequiredSpecifies the type of the object being tagged. Acceptable values are 'commit', 'tree', or 'blob'.
author_of_tag_namestringOptionalThe name of the author of the tag. It should be a string providing the full name.
tagger_emailstringOptionalThe email address of the tag author. This should be in a valid email format.
tagging_datestringOptionalThe date and time when the object was tagged, in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'git/create-tag'.
#

GithubApi.CreateGitTree

Create or modify a git tree in a GitHub repository. Use this tool to create or modify a tree structure in a specified GitHub repository. It is useful for organizing files and directories within a repository's tree. Note that after creating or modifying a tree, you must commit the changes and update the branch reference. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe GitHub account owner of the repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository. It is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'git/create-tree'.
#

GithubApi.CreateGlobalWebhook

Create a global webhook in GitHub Enterprise Admin. Use this tool to create a global webhook for GitHub Enterprise. It should be called when you need to set up notifications for all repositories across the organization.

Parameters

ParameterTypeReq.Description
payload_delivery_urlstringRequiredThe destination URL where the webhook payloads will be delivered. Ensure this URL is accessible and properly configured to handle incoming requests.
webhook_typestringRequiredSpecifies the type of webhook. Must be set to "web".
hmac_key_for_signaturestringOptionalThe key for generating the HMAC hex digest in the X-Hub-Signature header. Optional.
payload_content_typestringOptionalSpecifies the media type for payload serialization. Options: 'json', 'form'. Default is 'form'.
send_notificationsbooleanOptionalSet to `true` to send notifications when the webhook is triggered.
ssl_verificationstringOptionalSet '0' to verify SSL certificate of the host for the URL; '1' to skip verification. Default is '0'. Avoid setting to '1' to prevent security risks.
trigger_eventsarray<string>OptionalList of events that trigger the webhook. Default events are `user` and `organization`.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/create-global-webhook'.
#

GithubApi.CreateImpersonationOauthToken

Create an impersonation OAuth token for a GitHub user. This tool is used to generate an impersonation OAuth token for a specified GitHub user, typically for enterprise administration purposes. It should be called when there is a need to access a user's resources on their behalf in an enterprise GitHub environment.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user account handle for which to create the impersonation OAuth token.
oauth_scopes_listarray<string>RequiredA list of scopes defining the permissions for the OAuth token. Each scope is a string representing a specific set of access rights. Refer to [scopes documentation](https://docs.github.com/enterprise-server@3.8/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/) for valid options.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/create-impersonation-o-auth-token'.
#

GithubApi.CreateOrgProjectGithub

Create a project board for a GitHub organization. This tool creates a project board within a specified GitHub organization. It should be called when you need to set up a new project board for organizational tasks. It returns details about the created project or errors if projects are disabled, insufficient privileges are available, or the organization lacks classic projects.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name. Not case sensitive.
project_namestringRequiredThe name of the project board to be created. It will serve as the identifier for the project within the organization. Must be a string.
project_descriptionstringOptionalThe description of the project to be created for the GitHub organization. This should be a clear and concise explanation of the project's purpose.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/create-for-org'.
#

GithubApi.CreateOrgRunnerRegistrationToken

Generate a registration token for GitHub organization runners. Use this tool to obtain a registration token for configuring a self-hosted runner in a GitHub organization. The token is valid for one hour and requires authentication with an access token having the 'admin:org' scope.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. This is not case-sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/create-registration-token-for-org'.
#

GithubApi.CreateOrUpdateGithubRepoSecret

Create or update a GitHub repository secret with an encrypted value. Use this tool to create or update a secret in a GitHub repository by providing an encrypted value. Requires authentication with a token having the `repo` scope or GitHub App permissions. Useful for managing sensitive information in repositories.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
secret_namestringRequiredThe name of the secret to create or update in the repository.
encrypted_secret_valuestringOptionalThe secret's value encrypted with LibSodium using a repository's public key.
encryption_key_idstringOptionalProvide the ID of the key used to encrypt the secret.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/create-or-update-repo-secret'.
#

GithubApi.CreateOrUpdateOrgSecret

Create or update an organization's secret on GitHub. Use this tool to create or update a secret within a GitHub organization using an encrypted value. The secret must be encrypted with LibSodium, and authentication requires a token with 'admin:org' scope. GitHub Apps need 'secrets' organization permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
repository_visibilitystringRequiredSpecifies which type of organization repositories have access to the organization secret. Choices are 'all', 'private', or 'selected'.
secret_namestringRequiredThe name of the secret. It's used to identify the secret within the organization.
encrypted_secret_valuestringOptionalThe secret's encrypted value using LibSodium and a GitHub org public key.
encryption_key_idstringOptionalThe ID of the public key used to encrypt the secret. This must match the key used during encryption.
repository_ids_for_secret_accessarray<integer>OptionalArray of repository ids allowed access to the secret. Provide only when `visibility` is `selected`.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/create-or-update-org-secret'.
#

GithubApi.CreatePreReceiveEnvironment

Create a new pre-receive environment on GitHub Enterprise. This tool is used to create a pre-receive environment in GitHub Enterprise. It should be called when you need to set up an environment for pre-receive hooks.

Parameters

ParameterTypeReq.Description
pre_receive_environment_namestringRequiredThe name of the new pre-receive environment to be created.
tarball_download_urlstringRequiredURL to download the tarball for the pre-receive environment setup.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/create-pre-receive-environment'.
#

GithubApi.CreatePreReceiveHook

Create a pre-receive hook for GitHub enterprise administration. Use this tool when you need to create a pre-receive hook for managing GitHub enterprise repositories. It's crucial for setting up checks before code is accepted. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/create-pre-receive-hook'.
#

GithubApi.CreateProjectColumn

Create a new column in a GitHub project. This tool creates a new column in a specified GitHub project board. Useful for organizing tasks or issues within project management workflows.

Parameters

ParameterTypeReq.Description
column_namestringRequiredThe name of the column to be created in the GitHub project.
project_idintegerRequiredThe unique integer identifier for the GitHub project where the column will be created.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/create-column'.
#

GithubApi.CreatePullRequestReviewComment

Create a review comment on a GitHub pull request. This tool is used to create a review comment in the diff of a GitHub pull request. It uses parameters like `line`, `side`, `start_line`, and `start_side` for precise placement of comments in the pull request diff to provide feedback or suggestions. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe GitHub username or organization name of the repository owner. This value is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the GitHub repository where the pull request exists. This value is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
pull_request_numberintegerOptionalThe unique number that identifies the pull request within the repository. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/create-review-comment'.
#

GithubApi.CreateReplyToReviewComment

Create a reply to a top-level review comment on a pull request. This tool creates a reply to a top-level review comment on a pull request. Users can utilize this tool when they need to respond to review comments made on their pull requests, ensuring proper communication and collaboration. Note that replies to replies are not supported. Creating content too quickly may trigger secondary rate limits.

Parameters

ParameterTypeReq.Description
pull_request_numberintegerRequiredThe number identifying the pull request to reply to.
repository_namestringRequiredThe name of the repository. This name is not case sensitive and identifies the repository where the reply will be posted.
repository_ownerstringRequiredThe account owner of the repository. Not case sensitive.
review_comment_textstringRequiredThe content of the reply to the top-level review comment. This should be a string containing the reply text.
review_comment_unique_idintegerRequiredThe unique identifier for the top-level review comment you are replying to. Replies to replies are not supported.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/create-reply-for-review-comment'.
#

GithubApi.CreateRepoDependencySnapshot

Create a snapshot of a repository's dependencies. This tool creates a new snapshot of a GitHub repository's dependencies. It requires authentication with an access token that has the `repo` scope. Use this tool to capture the current state of a repository's dependencies for analysis or auditing. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the GitHub repository. This name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the GitHub repository to create a dependency snapshot for. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependency-graph/create-repository-snapshot'.
#

GithubApi.CreateRepoFromTemplate

Create a new repository from a template. Use this tool to create a new GitHub repository using an existing repository template. Specify the template by providing the template owner's and repository's names. Ensure the template is accessible and the necessary OAuth scopes are authorized. This tool is useful when needing to quickly start a new project with predefined settings and structure.

Parameters

ParameterTypeReq.Description
new_repository_namestringRequiredThe name of the new repository to be created using the template.
template_repository_namestringRequiredThe name of the repository template to use for creating the new repository.
template_repository_ownerstringRequiredUsername or organization name that owns the template repository.
create_private_repositorybooleanOptionalSet to true to create a private repository, or false to create a public one.
include_all_branches_from_templatebooleanOptionalSet to true to include files from all branches in the template repository, not just the default branch. Default: false.
repository_descriptionstringOptionalA short description of the new GitHub repository to be created from the template.
repository_ownerstringOptionalThe organization or user that will own the new repository. Must be a valid organization member if creating under an organization.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-using-template'.
#

GithubApi.CreateRepoRegistrationToken

Obtain a registration token for GitHub repository actions. Use this tool to get a token needed to configure a self-hosted runner for a GitHub repository. The token expires after one hour and requires authentication with a `repo`-scoped token.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Provide the GitHub username or organization name. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/create-registration-token-for-repo'.
#

GithubApi.CreateRepositoryTagProtection

Create tag protection for a GitHub repository. This tool creates a tag protection state for a repository on GitHub, available only to repository administrators.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
tag_protection_patternstringRequiredAn optional glob pattern for matching when enforcing tag protection.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-tag-protection'.
#

GithubApi.CreateRunnerGroupForOrg

Create a self-hosted runner group for an organization. This tool creates a new self-hosted runner group for an organization on GitHub. Requires authentication with an access token having the `admin:org` scope.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. It is not case sensitive.
runner_group_namestringRequiredName of the self-hosted runner group to be created. This should be a descriptive and distinct name within your organization.
accessible_repository_idsarray<integer>OptionalList of repository IDs that can access the runner group.
allow_public_repositoriesbooleanOptionalSet to true to allow the runner group to be used by public repositories.
allowed_workflowsarray<string>OptionalList of workflows names the runner group is permitted to run. Considered only if 'restricted_to_workflows' is true.
restrict_to_selected_workflowsbooleanOptionalSet to true to restrict the runner group to run only the workflows in the selected_workflows array.
runner_group_visibilitystringOptionalSpecify the visibility of the runner group: 'selected' for individual repositories, 'all' for all repositories, or 'private' for private repositories only.
runner_ids_to_addarray<integer>OptionalList of runner IDs to include in the newly created runner group for the organization.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/create-self-hosted-runner-group-for-org'.
#

GithubApi.CreateSelfHostedRunnerGroup

Create a self-hosted runner group for an enterprise. Use this tool to create a new self-hosted runner group for an enterprise on GitHub. Requires authentication with an access token having the `manage_runners:enterprise` scope.

Parameters

ParameterTypeReq.Description
enterprise_name_or_idstringRequiredThe slug version of the enterprise name or the enterprise ID to identify the enterprise.
runner_group_namestringRequiredName of the runner group to be created.
allow_public_repository_usebooleanOptionalSet to true to allow the runner group to be used by public repositories.
organization_ids_for_accessarray<integer>OptionalList of IDs for organizations allowed to access the runner group.
restrict_to_selected_workflowsbooleanOptionalSet to true to restrict the runner group to only the workflows in 'selected_workflows'.
runner_group_visibilitystringOptionalSpecifies the visibility of the runner group: 'selected' for individual organizations or 'all' for all organizations.
runner_idsarray<integer>OptionalList of runner IDs to be added to the new runner group.
workflows_allowed_for_runner_grouparray<string>OptionalList of workflows the runner group can run. Ignored unless `restricted_to_workflows` is `true`.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/create-self-hosted-runner-group-for-enterprise'.
#

GithubApi.CreateSshSigningKeyGithub

Create an SSH signing key for your GitHub account. This tool allows authenticated users to create an SSH signing key for their GitHub account. Authentication is required via Basic Authentication or OAuth with the `write:ssh_signing_key` scope. It should be used when you need to add SSH signing keys to your GitHub profile.

Parameters

ParameterTypeReq.Description
public_ssh_keystringRequiredThe public SSH key to add to your GitHub account. Check for existing SSH keys before adding.
ssh_key_titlestringOptionalA descriptive name for the new SSH signing key.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/create-ssh-signing-key-for-authenticated-user'.
#

GithubApi.CreateTeamDiscussionComment

Create a new comment on a team discussion in an organization. Use this tool to add a comment to an existing team discussion in a GitHub organization. This action requires appropriate permissions and will generate notifications. Be mindful of rate limits when using this tool.

Parameters

ParameterTypeReq.Description
comment_body_textstringRequiredThe text content of the comment to be added to the team discussion.
discussion_numberintegerRequiredThe number that identifies the specific discussion within the team to which you want to add a comment.
organization_namestringRequiredThe name of the organization where the team discussion is located. This is not case sensitive.
team_slugstringRequiredThe slug identifier for the team name within the organization, used to specify which team's discussion to comment on.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/create-discussion-comment-in-org'.
#

GithubApi.CreateTeamDiscussionGithub

Create a discussion post on a GitHub team's page. Use this tool to create a new discussion post on a specified team's page within an organization on GitHub. This requires appropriate OAuth access tokens with the `write:discussion` scope. Be aware that creating content too quickly can lead to rate limiting. This action will trigger notifications associated with the created discussion.

Parameters

ParameterTypeReq.Description
discussion_body_textstringRequiredThe content of the discussion post. Provide detailed text for the discussion body.
discussion_post_titlestringRequiredThe title for the discussion post on the team's page.
organization_namestringRequiredThe organization name, not case-sensitive, for which the team discussion will be created.
team_slugstringRequiredThe unique slug of the team name. This is required to specify which team's page the discussion will be posted on.
create_private_postbooleanOptionalSet to `true` to create a private post visible only to team members and maintainers, or `false` for a public post visible to all organization members.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/create-discussion-in-org'.
#

GithubApi.DeclineRepoInvitation

Decline an invitation to join a GitHub repository. Use this tool to decline an invitation for an authenticated user to join a specific GitHub repository. It should be called when a user decides not to accept a repository invitation.

Parameters

ParameterTypeReq.Description
invitation_idintegerRequiredThe unique identifier of the GitHub repository invitation to decline.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/decline-invitation-for-authenticated-user'.
#

GithubApi.DeleteAdminBranchProtection

Remove admin enforcement on a protected branch. This tool removes admin enforcement from a protected branch on GitHub. It requires admin or owner permissions for the repository and that branch protection is enabled. Use when you need to disable admin restrictions on a branch.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe exact name of the branch for which admin enforcement will be removed. Wildcards are not allowed.
repository_namestringRequiredThe name of the repository. It is not case sensitive and should not include any special characters.
repository_ownerstringRequiredThe GitHub account owner of the repository. This is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete-admin-branch-protection'.
#

GithubApi.DeleteBranchProtection

Remove protection from a specified GitHub branch. Use this tool to remove protection from a specific branch in a GitHub repository. Applicable for public repositories under GitHub Free and in both public and private repositories under GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. Ideal for scenarios where branch updates are needed.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe name of the branch to remove protection from. Cannot contain wildcard characters.
repository_namestringRequiredThe name of the GitHub repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete-branch-protection'.
#

GithubApi.DeleteCodeScanningAnalysis

Delete a specific code scanning analysis from a GitHub repository. Use this tool to delete a specific code scanning analysis from a repository on GitHub. Ensure you have the correct access token with the required scope. This tool should be called when you want to remove analyses, particularly in cases where the analysis is marked as deletable. It provides URLs for further deletions, allowing you to manage and maintain analyses effectively.

Parameters

ParameterTypeReq.Description
analysis_idintegerRequiredThe ID of the analysis to delete, obtained from the `GET /repos/{owner}/{repo}/code-scanning/analyses` endpoint.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
allow_final_analysis_deletionstringOptionalSet to 'true' to allow deletion if the analysis is the last in a set, preventing a 400 error.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'code-scanning/delete-analysis'.
#

GithubApi.DeleteCommitCommentReaction

Delete a reaction from a commit comment on GitHub. Use this tool to delete a specific reaction from a commit comment in a GitHub repository. This is useful when you need to manage or clean up reactions on comments.

Parameters

ParameterTypeReq.Description
comment_unique_identifierintegerRequiredThe unique identifier for the specific commit comment you want to target.
reaction_unique_identifierintegerRequiredThe unique identifier for the reaction to be deleted from a commit comment.
repository_namestringRequiredThe case-insensitive name of the repository.
repository_ownerstringRequiredThe account owner of the repository. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/delete-for-commit-comment'.
#

GithubApi.DeleteCustomRunnerLabel

Remove a custom label from a self-hosted runner in an organization. Removes a specified custom label from a self-hosted runner within an organization and returns the updated list of labels on the runner. Requires authentication with an access token having the `admin:org` scope. If the label is not found, a `404 Not Found` status is returned.

Parameters

ParameterTypeReq.Description
custom_label_namestringRequiredThe name of the custom label to remove from the self-hosted runner.
organization_namestringRequiredThe case-insensitive name of the organization.
runner_identifierintegerRequiredUnique identifier of the self-hosted runner. Must be an integer.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/remove-custom-label-from-self-hosted-runner-for-org'.
#

GithubApi.DeleteDeploymentBranchPolicy

Delete a deployment branch policy for a GitHub environment. Use this tool to delete a deployment branch policy in a specified environment on GitHub. Authentication with a token having `repo` scope is required, or GitHub Apps must have `administration:write` permission.

Parameters

ParameterTypeReq.Description
branch_policy_identifierintegerRequiredThe unique identifier of the branch policy to be deleted.
environment_namestringRequiredThe name of the GitHub environment for which the deployment branch policy will be deleted.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete-deployment-branch-policy'.
#

GithubApi.DeleteGistComment

Delete a comment from a GitHub gist. This tool deletes a specific comment from a GitHub gist when provided with the gist and comment IDs. It should be called when a user needs to remove an undesired or outdated comment.

Parameters

ParameterTypeReq.Description
comment_identifierintegerRequiredThe unique identifier of the comment to be deleted.
gist_identifierstringRequiredThe unique identifier for the specific GitHub gist from which the comment is to be deleted.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/delete-comment'.
#

GithubApi.DeleteGithubActionsCache

Delete a GitHub Actions cache by ID for a repository. Use this tool to delete a specific GitHub Actions cache from a repository using its cache ID. Requires authentication with a token having `repo` scope. Useful for managing and cleaning up repository caches.

Parameters

ParameterTypeReq.Description
github_actions_cache_idintegerRequiredThe unique identifier for the GitHub Actions cache to be deleted.
repository_namestringRequiredThe name of the repository. Not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/delete-actions-cache-by-id'.
#

GithubApi.DeleteGithubArtifact

Deletes a specified GitHub artifact. Use this tool to delete an artifact from a GitHub workflow run. Authentication with an access token having the `repo` scope is required, or a GitHub App must have `actions:write` permission.

Parameters

ParameterTypeReq.Description
artifact_unique_identifierintegerRequiredThe unique identifier of the artifact to be deleted. Must be an integer value.
repository_namestringRequiredThe name of the GitHub repository where the artifact resides. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository, case-insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/delete-artifact'.
#

GithubApi.DeleteGithubCommitComment

Deletes a specific commit comment on GitHub. Use this tool to remove a comment from a commit on a GitHub repository by specifying the owner, repository, and comment ID.

Parameters

ParameterTypeReq.Description
comment_idintegerRequiredThe unique identifier of the commit comment to be deleted.
repository_namestringRequiredThe name of the GitHub repository. This value is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete-commit-comment'.
#

GithubApi.DeleteGithubDeployKey

Delete a deploy key from a GitHub repository. Use this tool to delete an SSH deploy key from a specified GitHub repository. This is useful when you need to remove access provided by the key or when updating it (as keys are immutable on GitHub).

Parameters

ParameterTypeReq.Description
deploy_key_idintegerRequiredThe unique identifier for the deploy key to be deleted from the repository.
repository_namestringRequiredThe name of the GitHub repository. This value is not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. Not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete-deploy-key'.
#

GithubApi.DeleteGithubDeployment

Delete a GitHub repository deployment. Deletes a deployment from a GitHub repository. If there's only one deployment, it can be deleted regardless of status. If multiple deployments exist, only inactive ones can be deleted. Ideal for users with `repo` or `repo_deployment` scopes managing deployments.

Parameters

ParameterTypeReq.Description
deployment_idintegerRequiredThe unique identifier of the GitHub deployment to be deleted. This should be an integer.
repository_namestringRequiredThe name of the repository. This name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete-deployment'.
#

GithubApi.DeleteGithubEnterpriseUser

Delete a GitHub Enterprise user and their data. Use this tool to permanently delete a user on GitHub Enterprise, including all their data such as repositories and personal settings. Consider if suspending the user would be a better option before using this tool.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe handle for the GitHub user account to be deleted. Ensure it's the correct user, as this action is irreversible.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/delete-user'.
#

GithubApi.DeleteGithubEnvironmentSecret

Delete a GitHub environment secret by name. This tool deletes a specific secret from an environment in a GitHub repository. It requires authentication with an access token having the `repo` scope or a GitHub App with `secrets` repository permission. Use this tool to securely manage and remove secrets from your environments.

Parameters

ParameterTypeReq.Description
environment_namestringRequiredSpecify the name of the GitHub environment from which the secret will be deleted.
repository_idintegerRequiredThe unique identifier of the repository to delete the secret from.
secret_name_to_deletestringRequiredThe name of the secret to be deleted from the environment.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/delete-environment-secret'.
#

GithubApi.DeleteGithubEnvVariable

Deletes an environment variable in a GitHub repository environment. This tool is used to delete an environment variable from a specific environment in a GitHub repository. Authentication with an access token having the `repo` scope is required. GitHub Apps need the `environment:write` permission.

Parameters

ParameterTypeReq.Description
environment_namestringRequiredThe name of the environment from which the variable will be deleted.
repository_idintegerRequiredThe unique identifier of the GitHub repository where the environment variable will be deleted.
variable_namestringRequiredThe name of the environment variable to delete.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/delete-environment-variable'.
#

GithubApi.DeleteGithubFile

Delete a file from a GitHub repository. This tool deletes a specified file from a GitHub repository. It should be called when you need to remove a file, ensuring that either committer or author details such as name and email are provided. This action cannot be done concurrently with file creation or updates.

Parameters

ParameterTypeReq.Description
commit_messagestringRequiredThe commit message explaining why the file is being deleted. This information is mandatory.
file_pathstringRequiredThe file path in the repository to be deleted. This path is case-sensitive.
file_sha_to_deletestringRequiredThe SHA of the file to be deleted. This is required to identify the specific file version in the repository.
repository_namestringRequiredThe name of the GitHub repository from which the file will be deleted. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository in a case-insensitive format.
author_emailstringOptionalEmail of the author or committer for the commit. Required if using author or committer details.
author_namestringOptionalThe name of the author or committer of the commit. Required if 'author' is used.
branch_namestringOptionalThe name of the branch from which to delete the file. Defaults to the repository's default branch (usually 'master').
committer_emailstringOptionalThe email of the committer for the commit. This is required for deleting a file.
committer_namestringOptionalThe name of the committer or author of the commit for deleting the file.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete-file'.
#

GithubApi.DeleteGithubGist

Delete a GitHub gist by its ID. Use this tool to delete a specific GitHub gist by providing its gist ID. Useful for managing personal gists on GitHub.

Parameters

ParameterTypeReq.Description
gist_identifierstringRequiredThe unique identifier for the GitHub gist to be deleted.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/delete'.
#

GithubApi.DeleteGithubIssueComment

Delete a specific comment from a GitHub issue. Use this tool to delete a specific comment from an issue in a GitHub repository. Specify the comment ID, along with the owner and repository names, to remove the comment.

Parameters

ParameterTypeReq.Description
issue_comment_idintegerRequiredThe unique identifier of the comment to be deleted.
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is not case sensitive. Provide the username or organization name.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/delete-comment'.
#

GithubApi.DeleteGithubIssueCommentReaction

Deletes a reaction from a GitHub issue comment. Use this tool to remove a specific reaction from an issue comment on GitHub. Provide the necessary repository and comment identifiers to successfully delete the reaction.

Parameters

ParameterTypeReq.Description
issue_comment_idintegerRequiredThe unique identifier of the issue comment from which the reaction will be deleted.
reaction_identifierintegerRequiredThe unique identifier of the reaction to be deleted from the issue comment.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/delete-for-issue-comment'.
#

GithubApi.DeleteGithubIssueReaction

Deletes a reaction from a GitHub issue. Use this tool to delete a specific reaction on an issue in a GitHub repository. This is useful for managing feedback and maintaining issues without unnecessary reactions.

Parameters

ParameterTypeReq.Description
issue_numberintegerRequiredThe number identifying the issue in the repository.
reaction_identifierintegerRequiredThe unique identifier of the reaction to be deleted from a GitHub issue.
repository_namestringRequiredThe name of the GitHub repository. This value is not case sensitive. It identifies which repository the issue belongs to.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/delete-for-issue'.
#

GithubApi.DeleteGithubLabel

Delete a label from a GitHub repository. Use this tool to delete a specific label from a GitHub repository. It should be called when you need to remove a label identified by its name from a particular repository, specified by the owner and repository name.

Parameters

ParameterTypeReq.Description
label_namestringRequiredThe name of the label to delete from the repository. It should match the label exactly.
repository_namestringRequiredThe name of the GitHub repository from which to delete the label. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/delete-label'.
#

GithubApi.DeleteGithubMilestone

Delete a milestone from a GitHub repository. Use this tool to delete a specific milestone from a GitHub repository by providing the repository owner, name, and milestone number.

Parameters

ParameterTypeReq.Description
milestone_identifierintegerRequiredThe unique number that identifies the milestone to be deleted.
repository_namestringRequiredThe repository name on GitHub, not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. This should match the GitHub username or organization name. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/delete-milestone'.
#

GithubApi.DeleteGithubOrgMigrationArchive

Delete a previous GitHub organization migration archive. Use this tool to delete a migration archive for a GitHub organization. Migration archives are automatically deleted after seven days, but you might need to delete them sooner for organizational purposes.

Parameters

ParameterTypeReq.Description
migration_identifierintegerRequiredThe unique identifier of the migration archive to delete.
organization_namestringRequiredThe GitHub organization name. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'migrations/delete-archive-for-org'.
#

GithubApi.DeleteGithubOrgSecret

Deletes a secret from a GitHub organization. Use this tool to delete a specific secret from a GitHub organization by its name. Requires authentication with an access token with `admin:org` scope or a GitHub App with `secrets` permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name, not case sensitive.
secret_namestringRequiredThe name of the secret to be deleted from the GitHub organization. Ensure the name is correct and case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/delete-org-secret'.
#

GithubApi.DeleteGithubOrgVariable

Delete an organization's variable on GitHub. Deletes a specified variable from an organization on GitHub. Requires authentication with an access token with the `admin:org` scope, or GitHub App with `organization_actions_variables:write` permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. This is not case sensitive.
variable_namestringRequiredThe name of the organization variable to delete. It should be a string matching the variable's identifier.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/delete-org-variable'.
#

GithubApi.DeleteGithubPagesSite

Delete a GitHub Pages site from a repository. Use this tool to delete a GitHub Pages site from a specified repository. Requires repository admin or maintainer permissions with appropriate GitHub token scopes.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository from which to delete the GitHub Pages site. This name is not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. Case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete-pages-site'.
#

GithubApi.DeleteGithubPersonalAccessToken

Delete a GitHub personal access token. Deletes a specified GitHub personal access token. Use when you need to remove a token. If the token is in use, such as being accessed by the token itself, a '403 - Forbidden' status will be returned.

Parameters

ParameterTypeReq.Description
github_token_idintegerRequiredThe unique identifier of the GitHub personal access token to delete.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/delete-personal-access-token'.
#

GithubApi.DeleteGithubProjectColumn

Deletes a specific project column on GitHub. This tool deletes a specified column from a project on GitHub. It should be called when a user wants to remove a column from their project setup.

Parameters

ParameterTypeReq.Description
project_column_idintegerRequiredThe unique integer identifier of the GitHub project column to be deleted.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/delete-column'.
#

GithubApi.DeleteGithubPublicKey

Delete a public key from GitHub Enterprise. Use this tool to delete a specific public key from a GitHub Enterprise account. This should be called when an obsolete or compromised key needs to be removed.

Parameters

ParameterTypeReq.Description
public_key_identifierstringRequiredThe unique identifier of the public key to delete from GitHub Enterprise.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/delete-public-key'.
#

GithubApi.DeleteGithubPullRequestPendingReview

Delete a pending review for a GitHub pull request. Use this tool to delete a pending review from a specified pull request on GitHub.

Parameters

ParameterTypeReq.Description
pull_request_numberintegerRequiredThe number identifying the specific pull request to delete the pending review from.
repository_namestringRequiredThe name of the GitHub repository. This is not case sensitive.
repository_owner_namestringRequiredThe GitHub account owner of the repository. This is not case sensitive.
unique_review_identifierintegerRequiredThe unique identifier of the pending GitHub review to be deleted.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/delete-pending-review'.
#

GithubApi.DeleteGithubRelease

Delete a GitHub release with push access permissions. Call this tool to delete a release from a GitHub repository if you have push access. It removes the specified release identified by its release ID in the given repository.

Parameters

ParameterTypeReq.Description
release_identifierintegerRequiredThe unique identifier of the GitHub release to delete. This is an integer value.
repository_namestringRequiredThe name of the repository. It's not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository, not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete-release'.
#

GithubApi.DeleteGithubRepoSecret

Deletes a secret from a GitHub repository. Use this tool to remove a specific secret from a GitHub repository by providing the secret's name. Authentication with a `repo`-scoped access token is required. GitHub Apps need the `secrets` permission.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
secret_namestringRequiredThe specific name of the secret to delete from the repository.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/delete-repo-secret'.
#

GithubApi.DeleteGithubRepository

Deletes a specified GitHub repository. Use this tool to delete a GitHub repository when you have admin access and the necessary permissions. Ensure that OAuth is used with the 'delete_repo' scope if required. Be aware of organization-level restrictions that might prohibit deletion.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository you want to delete. This is not case sensitive.
repository_owner_namestringRequiredThe account owner of the repository; not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete'.
#

GithubApi.DeleteGithubRepoVariable

Delete a repository variable on GitHub using its name. This tool deletes a specified variable from a GitHub repository. It requires authentication with an access token that has the 'repo' scope. Suitable for use in managing repository configurations or cleanup tasks.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository to delete the variable from. It is not case-sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
variable_namestringRequiredThe name of the variable to delete from the repository. It should match exactly as stored.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/delete-repo-variable'.
#

GithubApi.DeleteGithubRequiredWorkflow

Deletes a required workflow in a GitHub organization. Use this tool to delete a specific required workflow configured in a GitHub organization. Requires authentication with an `admin:org` scope access token.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name. This is case insensitive.
workflow_identifierintegerRequiredThe unique identifier of the required workflow to be deleted.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/delete-required-workflow'.
#

GithubApi.DeleteGithubReviewComment

Delete a review comment on a GitHub pull request. Use this tool to delete a specific review comment on a GitHub pull request. It should be called when you need to remove an unnecessary or incorrect comment. Requires the repository owner, repository name, and the comment ID.

Parameters

ParameterTypeReq.Description
comment_idintegerRequiredThe unique identifier for the review comment to delete. This must be an integer and corresponds to the specific comment you intend to remove from the GitHub pull request.
repository_namestringRequiredThe name of the repository, case-insensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository, not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/delete-review-comment'.
#

GithubApi.DeleteGithubSshSigningKey

Delete an SSH signing key from your GitHub account. Call this tool to remove an SSH signing key from the authenticated user's GitHub account. Authentication is required via Basic Authentication or OAuth with the `admin:ssh_signing_key` scope.

Parameters

ParameterTypeReq.Description
ssh_signing_key_identifierintegerRequiredThe unique identifier of the SSH signing key to delete. It must be an integer.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/delete-ssh-signing-key-for-authenticated-user'.
#

GithubApi.DeleteGithubTeamDiscussionReaction

Delete a reaction from a GitHub team discussion. Use this tool to delete a reaction from a specific team discussion on GitHub. Requires appropriate OAuth scope: `write:discussion`.

Parameters

ParameterTypeReq.Description
discussion_numberintegerRequiredThe number that identifies the GitHub team discussion to delete a reaction from. Must be an integer.
organization_namestringRequiredThe organization name. This value is not case sensitive and identifies the GitHub organization.
reaction_unique_identifierintegerRequiredThe unique identifier for the specific reaction to be deleted from the discussion.
team_slugstringRequiredThe slug (URL-friendly version) of the team name in GitHub, used to identify a team within an organization.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/delete-for-team-discussion'.
#

GithubApi.DeleteGithubWorkflowRun

Delete a specific GitHub workflow run. Use this tool to delete a specific workflow run in a GitHub repository. Requires write access to the repository. For private repositories, an access token with `repo` scope is necessary. GitHub Apps need `actions:write` permission.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. The name is not case sensitive.
workflow_run_idintegerRequiredThe unique identifier of the GitHub workflow run to be deleted. This should be an integer value.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/delete-workflow-run'.
#

GithubApi.DeleteGithubWorkflowRunLogs

Deletes all logs for a specified workflow run on GitHub. Use this tool to delete all logs associated with a specific workflow run in a GitHub repository. Authentication with a token having `repo` scope is necessary, and GitHub Apps need `actions:write` permission.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case-sensitive.
repository_owner_namestringRequiredThe account owner of the repository. This name is not case sensitive.
workflow_run_idintegerRequiredThe unique identifier of the workflow run to delete logs for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/delete-workflow-run-logs'.
#

GithubApi.DeleteGitReference

Deletes a specified Git reference in a repository. Use this tool to delete a specific Git reference from a repository on GitHub. It is useful for managing and cleaning up branches, tags, or other references in a repository.

Parameters

ParameterTypeReq.Description
git_reference_to_deletestringRequiredThe Git reference to delete, such as a branch or tag name. This should match the exact format used in the repository.
repository_namestringRequiredThe name of the repository to delete the reference from. It is not case sensitive.
repository_ownerstringRequiredThe GitHub username of the repository owner. This is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'git/delete-ref'.
#

GithubApi.DeleteGlobalWebhook

Delete a global webhook in GitHub Enterprise. Use this tool to delete a global webhook in a GitHub Enterprise setup. It should be called when there's a need to remove a webhook that is no longer required.

Parameters

ParameterTypeReq.Description
webhook_idintegerRequiredThe unique identifier of the global webhook to be deleted.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/delete-global-webhook'.
#

GithubApi.DeleteImpersonationOauthToken

Deletes an impersonation OAuth token for a user in GitHub Enterprise Admin. Use this tool to remove an OAuth token for a specific user's impersonation in GitHub Enterprise Admin. This is useful for security and access management in organization environments.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user account handle for which the impersonation OAuth token will be deleted.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/delete-impersonation-o-auth-token'.
#

GithubApi.DeleteOrgWebhook

Delete a webhook from a GitHub organization. Use this tool to delete a specific webhook from a GitHub organization by specifying the organization and webhook ID.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is case insensitive.
webhook_identifierintegerRequiredThe unique identifier of the webhook to be deleted. It should be provided as an integer.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/delete-webhook'.
#

GithubApi.DeletePreReceiveEnvironment

Delete a specified pre-receive environment in GitHub Enterprise. This tool deletes a specified pre-receive environment by its ID in GitHub Enterprise. If the environment cannot be deleted, a `422 Unprocessable Entity` response is returned with potential error messages indicating that the default environment cannot be modified or deleted, hooks are present, or a download is in progress.

Parameters

ParameterTypeReq.Description
pre_receive_environment_identifierintegerRequiredThe unique integer identifier of the pre-receive environment to be deleted.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/delete-pre-receive-environment'.
#

GithubApi.DeletePreReceiveHook

Delete a pre-receive hook from GitHub Enterprise Admin. This tool deletes a pre-receive hook from a GitHub Enterprise Server instance. Use it when you need to remove a specific pre-receive hook, identified by its ID, from the administrative settings.

Parameters

ParameterTypeReq.Description
pre_receive_hook_identifierintegerRequiredThe unique identifier for the pre-receive hook to delete.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/delete-pre-receive-hook'.
#

GithubApi.DeleteProjectBoard

Deletes a specified project board on GitHub. Use this tool to delete a GitHub project board with a given project ID. It is useful for managing and cleaning up project boards. If projects are disabled, a `404 Not Found` status will be returned.

Parameters

ParameterTypeReq.Description
project_identifierintegerRequiredThe unique identifier of the GitHub project board to be deleted.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/delete'.
#

GithubApi.DeleteProjectCard

Delete a project card from GitHub projects. Call this tool when you need to delete a specific project card from a GitHub project board by providing the card ID.

Parameters

ParameterTypeReq.Description
card_idintegerRequiredThe unique identifier of the project card to delete.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/delete-card'.
#

GithubApi.DeletePullRequestCommentReaction

Delete a reaction from a pull request comment. Use this tool to delete a specific reaction from a pull request review comment on GitHub. Ideal for managing or retracting reactions erroneously added.

Parameters

ParameterTypeReq.Description
comment_unique_idintegerRequiredThe unique identifier of the pull request comment to delete a reaction from.
reaction_unique_identifierintegerRequiredThe unique identifier for the reaction to delete from the pull request comment.
repository_namestringRequiredThe name of the GitHub repository. It is case insensitive.
repository_ownerstringRequiredThe account owner of the repository. This is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/delete-for-pull-request-comment'.
#

GithubApi.DeleteReleaseAsset

Deletes a specific release asset on GitHub. Use this tool to delete a specified release asset from a GitHub repository. Provide the owner, repository name, and asset ID to perform the deletion.

Parameters

ParameterTypeReq.Description
asset_identifierintegerRequiredThe unique identifier for the GitHub release asset to be deleted.
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete-release-asset'.
#

GithubApi.DeleteReleaseReaction

Delete a reaction from a GitHub release. Use this tool to delete a specific reaction from a GitHub release by providing the repository owner, repo, release ID, and reaction ID. It should be called when you need to manage reactions on releases.

Parameters

ParameterTypeReq.Description
reaction_identifierintegerRequiredThe unique identifier for the reaction to be deleted from a release.
release_idintegerRequiredThe unique identifier of the GitHub release. Use this to specify which release's reaction you wish to delete.
repository_namestringRequiredThe name of the repository. This field is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/delete-for-release'.
#

GithubApi.DeleteRepoEnvironment

Deletes a specific environment in a GitHub repository. Use this tool to delete an environment from a repository on GitHub. Authentication with a valid access token is required. Suitable when you need to remove obsolete or unused environments.

Parameters

ParameterTypeReq.Description
environment_namestringRequiredThe name of the GitHub repository environment to delete. This field is case insensitive.
repository_namestringRequiredThe name of the GitHub repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This value is not case sensitive. Specify the GitHub username or organization handle that owns the repository.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete-an-environment'.
#

GithubApi.DeleteRepoFromOrgSecret

Remove a repository from a GitHub organization secret. Use this tool to remove a specific repository from an organization secret in GitHub. This is applicable when the repository access visibility is set to 'selected'. Ensure authentication with an access token that has the 'admin:org' scope. GitHub Apps require 'dependabot_secrets' permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
repository_idintegerRequiredThe unique identifier of the repository to be removed from the organization secret.
secret_namestringRequiredThe name of the GitHub organization secret to remove the repository from.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/remove-selected-repo-from-org-secret'.
#

GithubApi.DeleteRepoInvitation

Delete a repository invitation on GitHub. Use this tool to delete a specific invitation to collaborate on a GitHub repository. It requires the owner, repository name, and invitation ID to perform the deletion.

Parameters

ParameterTypeReq.Description
invitation_idintegerRequiredThe unique identifier for the repository invitation to be deleted. It must be an integer.
repository_namestringRequiredThe name of the GitHub repository to delete the invitation from. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This value is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete-invitation'.
#

GithubApi.DeleteRepositoryTagProtection

Deletes a tag protection from a GitHub repository. This tool is used to delete a tag protection state within a specified GitHub repository. It is only accessible to repository administrators.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This field is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
tag_protection_identifierintegerRequiredThe unique identifier for the tag protection to be deleted. Required for identifying which tag protection state to remove.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete-tag-protection'.
#

GithubApi.DeleteRepoWebhook

Delete a webhook from a GitHub repository. Use this tool to remove a specific webhook from a GitHub repository by providing the repository owner, name, and hook ID. It is helpful for managing webhooks that are no longer needed or require updating.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. This input is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This name is not case sensitive. Provide the GitHub username or organization name.
webhook_identifierintegerRequiredThe unique integer identifier of the webhook to be deleted.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete-webhook'.
#

GithubApi.DeleteRunnerGroupFromOrganization

Delete a self-hosted runner group from an organization. Use this tool to delete a self-hosted runner group from a specified organization on GitHub. Requires authentication with an access token with `admin:org` scope.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization on GitHub. This is not case-sensitive.
runner_group_idintegerRequiredThe unique integer ID of the self-hosted runner group to delete.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/delete-self-hosted-runner-group-from-org'.
#

GithubApi.DeleteScimGroupFromEnterprise

Delete a SCIM group from an enterprise. Use this tool to delete a SCIM group from an enterprise using the GitHub API. Ideal for managing user groups within enterprise accounts.

Parameters

ParameterTypeReq.Description
scim_group_idstringRequiredThe unique identifier of the SCIM group to delete from an enterprise.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/delete-scim-group-from-enterprise'.
#

GithubApi.DeleteSelfHostedRunnerGroup

Delete a self-hosted runner group for an enterprise. Use this tool to delete a self-hosted runner group from an enterprise. It requires authentication with an access token that has the `manage_runners:enterprise` scope. Call this tool when you need to manage enterprise runner groups on GitHub.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug version of the enterprise name or the enterprise ID to identify which enterprise the runner group belongs to.
runner_group_idintegerRequiredUnique identifier for the self-hosted runner group to be deleted.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/delete-self-hosted-runner-group-from-enterprise'.
#

GithubApi.DeleteTeamDiscussion

Delete a discussion from a team's page on GitHub. This tool deletes a specified discussion from a team's page within an organization on GitHub. It requires an OAuth access token with `write:discussion` scope. Use this tool when you need to remove a discussion from a team's page.

Parameters

ParameterTypeReq.Description
discussion_numberintegerRequiredThe unique number identifying the discussion to be deleted.
organization_namestringRequiredThe organization name on GitHub. It is not case sensitive.
team_slugstringRequiredThe slug identifier of the team name on GitHub. This is required to specify which team's discussion is to be deleted.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/delete-discussion-in-org'.
#

GithubApi.DeleteTeamDiscussionComment

Deletes a comment on a team discussion in an organization. Use this tool to delete a specific comment from a team discussion within a GitHub organization. Ideal for managing discussions and removing unwanted comments. Requires `write:discussion` OAuth scope.

Parameters

ParameterTypeReq.Description
comment_identifierintegerRequiredThe unique number identifying the comment to be deleted.
discussion_identifierintegerRequiredThe unique number identifying the discussion for the comment to be deleted.
organization_namestringRequiredThe name of the organization. It is not case sensitive.
team_slugstringRequiredThe slug of the team name in the organization. Case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/delete-discussion-comment-in-org'.
#

GithubApi.DeleteTeamDiscussionCommentReaction

Delete a reaction from a team discussion comment on GitHub. Use this tool to delete a reaction from a specific comment in a team discussion on GitHub. You need appropriate OAuth access tokens with `write:discussion` scope. Specify team, organization, discussion, comment, and reaction details to execute.

Parameters

ParameterTypeReq.Description
comment_identifierintegerRequiredThe number that identifies the comment in the team discussion.
discussion_identifierintegerRequiredThe number identifying the specific discussion in the team.
organization_namestringRequiredThe organization name on GitHub. It is not case sensitive.
reaction_idintegerRequiredThe unique identifier of the reaction to be deleted. This should be an integer value.
team_slugstringRequiredThe slug of the team name, used to identify the team in the organization.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/delete-for-team-discussion-comment'.
#

GithubApi.DeleteTeamInOrg

Delete a team in a GitHub organization. Use this tool to delete a team within a GitHub organization. The action requires the user to be an organization owner or team maintainer. Deleting a parent team will also delete its child teams.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe case-insensitive name of the GitHub organization containing the team to be deleted.
team_slugstringRequiredThe unique slug identifier of the team within the organization to be deleted.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/delete-in-org'.
#

GithubApi.DeleteUserEmail

Delete an email for the authenticated GitHub user. Use this tool to delete an email address associated with the authenticated user's GitHub account. This action requires user authentication and appropriate permissions. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/delete-email-for-authenticated-user'.
#

GithubApi.DeleteUserFromEnterprise

Permanently delete a SCIM user from an enterprise account. This tool permanently deletes a SCIM user from a GitHub enterprise account. It removes all user data, obfuscates personal information, and deletes associated credentials. This action is irreversible and should be used with caution.

Parameters

ParameterTypeReq.Description
scim_user_identifierstringRequiredThe unique identifier of the SCIM user to be permanently deleted from the enterprise.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/delete-user-from-enterprise'.
#

GithubApi.DemoteGithubSiteAdministrator

Demote a GitHub site administrator. This tool is used to demote a GitHub site administrator account. It cannot be used to demote your own account. Call this tool when you need to reduce the administrative privileges of a user on GitHub Enterprise.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user account handle to be demoted.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/demote-site-administrator'.
#

GithubApi.DisableCommitSignatureProtection

Disable required signed commits on a branch. This tool disables required signed commits on a specified branch in a GitHub repository. It requires admin or owner permissions and is applicable when branch protection is enabled.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe name of the branch where you want to disable commit signature protection. Wildcards are not allowed.
repository_namestringRequiredThe name of the GitHub repository, case insensitive.
repository_ownerstringRequiredThe account owner of the repository. Not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete-commit-signature-protection'.
#

GithubApi.DisableGithubActionsRepo

Disable GitHub Actions for a specific repo in an organization. Use this tool to remove a repository from the selected list of repositories enabled for GitHub Actions within an organization. This is applicable when the organization's repository permission policy is set to 'selected'. Authentication with an access token having 'admin:org' scope is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
repository_unique_idintegerRequiredThe unique integer identifier of the repository to be disabled for GitHub Actions.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/disable-selected-repository-github-actions-organization'.
#

GithubApi.DisableLfsForGithubRepo

Disable Git LFS for a specified GitHub repository. Use this tool to disable Git Large File Storage (LFS) for a specific GitHub repository. Requires admin access.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository to disable LFS for. This value is not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. This is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/disable-lfs-for-repo'.
#

GithubApi.DisableOrgGithubActions

Disable GitHub Actions for an organization in an enterprise. This tool removes a specified organization from the list enabled for GitHub Actions within an enterprise. It requires the enterprise permission policy for `enabled_organizations` to be set to `selected`, and an access token with `admin:enterprise` scope is needed for authentication. Use this when you need to disable GitHub Actions for an organization in your enterprise.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug version of the enterprise name or the enterprise ID to identify it for the operation.
organization_unique_identifierintegerRequiredThe unique identifier of the organization to disable GitHub Actions for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/disable-selected-organization-github-actions-enterprise'.
#

GithubApi.DismissPullRequestReview

Dismiss a pull request review on GitHub. This tool allows you to dismiss a review on a pull request within a GitHub repository. It requires repository administrator privileges or permissions to dismiss reviews on protected branches.

Parameters

ParameterTypeReq.Description
dismissal_messagestringRequiredThe message explaining the reason for dismissing the pull request review.
pull_request_numberintegerRequiredThe unique number identifying the pull request to dismiss the review for.
repository_namestringRequiredThe name of the GitHub repository. The name is not case sensitive.
repository_ownerstringRequiredThe username of the repository owner. This is not case sensitive and refers to the account that owns the repository.
review_identifierintegerRequiredThe unique identifier for the pull request review to be dismissed.
dismissal_eventstringOptionalThis is a required event type for dismissing a pull request review. Use 'DISMISS' to perform the dismissal action.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/dismiss-review'.
#

GithubApi.DownloadGithubMigrationArchive

Fetch the URL to download a GitHub migration archive. Use this tool to obtain the URL for downloading a GitHub migration archive as a `tar.gz` file. It includes various repository data and attachments, useful for backing up or migrating GitHub data.

Parameters

ParameterTypeReq.Description
migration_unique_idintegerRequiredThe unique identifier for the GitHub migration. This ID is required to fetch the migration archive URL.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'migrations/get-archive-for-authenticated-user'.
#

GithubApi.DownloadGithubReleaseAsset

Download binary content of a GitHub release asset. This tool downloads the binary content of a specific asset from a GitHub release. It should be called when you need to obtain the asset file from a GitHub repository release. The endpoint returns binary data, and clients must handle 200 or 302 HTTP responses.

Parameters

ParameterTypeReq.Description
asset_unique_identifierintegerRequiredThe unique identifier of the asset to download from a GitHub release. Must be an integer.
repository_namestringRequiredThe name of the GitHub repository, not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-release-asset'.
#

GithubApi.DownloadGithubRepoTarball

Retrieve a URL to download a GitHub repository tarball. This tool provides a redirect URL for downloading a tar archive of a GitHub repository. If the `:ref` is omitted, it defaults to the repository’s main branch. Note that for private repositories, the link expires after five minutes. Ensure your HTTP framework can follow redirects, or use the 'Location' header for a second GET request.

Parameters

ParameterTypeReq.Description
branch_or_commit_refstringRequiredSpecify the branch name or commit SHA for the repository. If omitted, the default branch is used.
repository_namestringRequiredThe name of the GitHub repository. This input is not case sensitive. Specify the repository whose tarball you want to download.
repository_ownerstringRequiredThe GitHub account owner of the repository. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/download-tarball-archive'.
#

GithubApi.DownloadGithubRepoZip

Retrieve a URL to download a GitHub repository as a zip file. This tool retrieves a redirect URL for downloading a zip archive of a specified GitHub repository. If no branch is specified, the repository's default branch will be used. Note that for private repositories, the links expire after five minutes, and empty repositories will return a 404 error.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. Not case sensitive.
repository_referencestringRequiredSpecify the branch, tag, or commit SHA to retrieve the zip archive from. Defaults to the repository's default branch if omitted.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/download-zipball-archive'.
#

GithubApi.DownloadGithubWorkflowJobLogs

Retrieve a URL to download GitHub workflow job logs. Use this tool to get a link for downloading logs of a specific GitHub workflow job. The link is a plain text file URL and expires in 1 minute. Users must have read access to the repository. For private repositories, an access token with 'repo' scope is required, or 'actions:read' permission for GitHub Apps.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository (case insensitive).
repository_ownerstringRequiredThe account owner of the GitHub repository. Provide the name in a non-case sensitive format.
workflow_job_idintegerRequiredThe unique identifier of the GitHub workflow job to download logs for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/download-job-logs-for-workflow-run'.
#

GithubApi.DownloadWorkflowRunLogs

Get a redirect URL to download workflow run log files. This tool retrieves a URL for downloading an archive of log files from a specific GitHub repository workflow run. The link expires after one minute. Use this tool when you need access to the logs for analysis or debugging, ensuring you have the necessary read access or appropriate access token if the repository is private.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. This field is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is case-insensitive.
workflow_run_idintegerRequiredThe unique identifier of the workflow run to download logs for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/download-workflow-run-logs'.
#

GithubApi.EditGithubReleaseAsset

Edit a GitHub release asset with push access. This tool allows users with push access to a GitHub repository to edit details of a release asset, such as its name or description. It should be called when there is a need to update release asset information.

Parameters

ParameterTypeReq.Description
release_asset_identifierintegerRequiredThe unique integer identifier of the release asset to update.
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
alternate_asset_descriptionstringOptionalProvide an alternate short description of the release asset, used instead of the filename.
file_name_of_assetstringOptionalThe file name of the asset. This is used to uniquely identify the asset file for the release.
release_asset_statestringOptionalSpecifies the state of the release asset. Possible values might include 'uploaded', 'deleted', etc. (API documentation does not explicitly define options).

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/update-release-asset'.
#

GithubApi.EditGithubReviewComment

Edit a review comment on a GitHub pull request.

Parameters

ParameterTypeReq.Description
comment_identifierintegerRequiredThe unique identifier for the GitHub review comment to be edited.
comment_textstringRequiredThe content of the updated review comment.
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository, not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/update-review-comment'.
#

GithubApi.EnableGithubActionsForOrg

Enable GitHub Actions for a selected organization in an enterprise. This tool adds an organization to the list enabled for GitHub Actions within an enterprise. The enterprise's permissions must allow 'selected' organizations. Requires an access token with 'admin:enterprise' scope.

Parameters

ParameterTypeReq.Description
enterprise_slug_or_idstringRequiredThe slug or ID of the enterprise to identify it for GitHub Actions enablement. Accepts slug version or enterprise ID.
organization_idintegerRequiredThe unique identifier for the organization to enable GitHub Actions. Must be an integer.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/enable-selected-organization-github-actions-enterprise'.
#

GithubApi.EnableGithubActionsForRepo

Enable a repository for GitHub Actions in an organization. Adds a repository to the list of selected repositories enabled for GitHub Actions within an organization. Requires organization permission policy for `enabled_repositories` set to `selected`. Authentication with `admin:org` scope is necessary.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization to enable GitHub Actions for, not case sensitive.
repository_unique_identifierintegerRequiredThe unique identifier of the repository to enable for GitHub Actions.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/enable-selected-repository-github-actions-organization'.
#

GithubApi.EnableGitLfs

Enables Git LFS for a specified repository. Use this tool to activate Git Large File Storage (LFS) for a given repository. The access token must have the `admin:enterprise` scope.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/enable-lfs-for-repo'.
#

GithubApi.FetchCommitInfo

Retrieve details and signature verification for a Git commit. Use this tool to fetch a Git commit object, including detailed information about the commit and its signature verification status. It's ideal for checking commit integrity and authenticity in a GitHub repository.

Parameters

ParameterTypeReq.Description
commit_shastringRequiredThe SHA hash of the commit to retrieve details and verification status for.
repository_namestringRequiredThe name of the repository to query. This input is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'git/get-commit'.
#

GithubApi.FetchDeploymentStatusGithub

Retrieve a deployment status from a GitHub repository. Used to view detailed information about a specific deployment status for a deployment in a GitHub repository. Suitable for users with pull access.

Parameters

ParameterTypeReq.Description
deployment_idintegerRequiredThe unique identifier of the deployment to retrieve the status for. Must be an integer.
deployment_status_idintegerRequiredThe unique integer identifier for the deployment status in the GitHub repository.
repository_namestringRequiredThe name of the repository (case-insensitive).
repository_ownerstringRequiredThe GitHub account owner of the repository. Not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-deployment-status'.
#

GithubApi.FetchGithubActionsCachePolicy

Retrieve the cache usage policy for GitHub Actions in a repository. This tool retrieves the GitHub Actions cache usage policy for a specified repository. It requires authentication with an access token that has the `repo` scope. GitHub Apps need the `actions:read` permission to access this endpoint.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-actions-cache-usage-policy'.
#

GithubApi.FetchGithubActionsPerms

Retrieve GitHub Actions permissions for a repository. Use this tool to get information on whether GitHub Actions is enabled for a repository and what actions are permitted. Requires authentication with a token with `repo` scope or a GitHub App with `administration` repository permission.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-github-actions-permissions-repository'.
#

GithubApi.FetchGithubIssueEvent

Retrieve details of a specific GitHub issue event. Use this tool to fetch information about a specific event related to an issue in a GitHub repository. Provide the owner, repository, and event ID to get detailed event information.

Parameters

ParameterTypeReq.Description
event_idintegerRequiredThe unique identifier for the GitHub issue event to retrieve details for. It must be an integer.
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive. Provide the GitHub username or organization name.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/get-event'.
#

GithubApi.FetchGitignoreTemplate

Fetches the raw .gitignore template by name. Use this tool to retrieve the raw source of a specified .gitignore template from GitHub. It is useful when you need to include or reference specific ignore rules for different development environments.

Parameters

ParameterTypeReq.Description
gitignore_template_namestringRequiredThe name of the .gitignore template to fetch from GitHub. This is required to specify which template's raw content to retrieve.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gitignore/get-template'.
#

GithubApi.FetchOpenRepoInvitations

List open repository invitations for the authenticated user. This tool retrieves all open repository invitations for the currently authenticated GitHub user. It's useful for checking pending repository collaborations.

Parameters

ParameterTypeReq.Description
page_numberintegerOptionalSpecify the page number of results to retrieve for open repository invitations.
results_per_pageintegerOptionalSpecify the number of results to display per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-invitations-for-authenticated-user'.
#

GithubApi.FetchOrgActionsCacheUsage

Fetches GitHub Actions cache usage for a specified organization. This tool retrieves the total cache usage of GitHub Actions for a specified organization. The data is updated every 5 minutes. Authentication with the 'read:org' scope is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. It should not be case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-actions-cache-usage-for-org'.
#

GithubApi.FetchOrgMigrationArchiveUrl

Fetches the URL to download an organization's migration archive. Use this tool to obtain the URL for downloading an archive of a migration for a specific organization on GitHub.

Parameters

ParameterTypeReq.Description
migration_identifierintegerRequiredThe unique identifier for the specific migration. This should be an integer value.
organization_namestringRequiredThe name of the organization. This value is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'migrations/download-archive-for-org'.
#

GithubApi.FetchRepoReadme

Retrieve the README from a specific repository directory. This tool retrieves the README file from a specified directory within a GitHub repository. It supports retrieving the content in various formats, including raw text and rendered HTML.

Parameters

ParameterTypeReq.Description
readme_directory_pathstringRequiredThe path within the repository to search for the README file. Default is repository root if not specified.
repository_namestringRequiredThe name of the repository. This input is case insensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. Case insensitive.
commit_branch_or_tag_namestringOptionalThe name of the commit, branch, or tag. Defaults to the repository's default branch (usually 'master').

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-readme-in-directory'.
#

GithubApi.FindGithubLabels

Search for labels in a GitHub repository by keywords. Use this tool to find labels in a specific GitHub repository whose names or descriptions match provided search keywords. Ideal for locating labels like 'bug' or 'enhancement' quickly. Returns up to 100 results per page, with optional text match metadata for enhanced search insights.

Parameters

ParameterTypeReq.Description
repository_idintegerRequiredThe ID of the repository where labels will be searched.
search_keywordsstringRequiredKeywords to search for in label names or descriptions. Excludes qualifiers.
result_page_numberintegerOptionalSpecifies the page number of the search results to fetch. Useful for pagination.
results_per_pageintegerOptionalThe number of label results to display per page, with a maximum of 100.
sort_labels_bystringOptionalSpecifies how to sort the query results by the timestamp fields 'created' or 'updated'. Defaults to 'best match'.
sort_orderstringOptionalDetermines if the highest ('desc') or lowest ('asc') matches appear first. Requires 'sort' to be set.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'search/labels'.
#

GithubApi.FollowGithubUser

Follow a specified user on GitHub. This tool allows you to follow a GitHub user. Ensure you are authenticated with the necessary permissions ('user:follow' scope) to execute this action. Useful when you want to keep up with updates from specific users on GitHub.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub username of the account you want to follow. Ensure it is a valid GitHub user handle.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/follow'.
#

GithubApi.ForkGist

Fork a GitHub gist to your account. Use this tool to create a fork of an existing GitHub gist into your account. This can be useful for modifying or duplicating code snippets while keeping track of the original version.

Parameters

ParameterTypeReq.Description
gist_unique_identifierstringRequiredThe unique identifier of the GitHub gist to be forked. This is required to specify which gist to duplicate.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/fork'.
#

GithubApi.GenerateGithubReleaseNotes

Generate release notes for a GitHub repository. This tool generates a markdown-formatted name and body for release notes, detailing changes since the last release and contributor information. It's useful when preparing to create a new release but does not save the notes.

Parameters

ParameterTypeReq.Description
release_tag_namestringRequiredSpecify the tag name for the release. Can be an existing tag or a new one.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. This is not case sensitive.
previous_tag_namestringOptionalThe name of the previous tag to use as the starting point for the release notes. It specifies the range of changes for this release.
release_configuration_file_pathstringOptionalPath to the configuration file in the repository for generating release notes. Defaults to '.github/release.yml' or '.github/release.yaml' if not specified.
target_commitstringOptionalThe commitish value that will target the release's tag. Required if tag_name doesn't reference an existing tag. Otherwise, it's ignored.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/generate-release-notes'.
#

GithubApi.GenerateGithubRunnerRemoveToken

Generate a token to remove a GitHub self-hosted runner. This tool generates a token needed to remove a self-hosted runner from a GitHub repository. The token is valid for one hour. Ensure authentication using an access token with the 'repo' scope before calling this tool.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This should match exactly as it appears on GitHub but is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/create-remove-token-for-repo'.
#

GithubApi.GetAdminBranchProtectionStatus

Get admin branch protection status on GitHub. Use this tool to fetch the admin branch protection status for a specific branch within a GitHub repository. This is applicable to both public and private repositories across various GitHub plans.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe exact name of the branch. Wildcards are not allowed; use GraphQL API for wildcards.
repository_namestringRequiredThe name of the GitHub repository. This name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-admin-branch-protection'.
#

GithubApi.GetAdvancedSecurityCommitters

Retrieve GitHub Advanced Security committers for an organization. Use this tool to obtain details about active committers using GitHub Advanced Security across repositories within a specified organization. This includes the total count of unique committers and repository-level details.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe organization name for which to retrieve security committers. It is not case sensitive.
results_page_numberintegerOptionalThe page number of the results to fetch. Useful for paginating through large sets of results.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum limit of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'billing/get-github-advanced-security-billing-org'.
#

GithubApi.GetAllAuthorizedSshKeys

Retrieve all authorized SSH keys for enterprise admin. Use this tool to fetch a comprehensive list of all SSH keys authorized within an enterprise GitHub environment. Useful for administrators managing access and security.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-all-authorized-ssh-keys'.
#

GithubApi.GetAllGithubCodesOfConduct

Retrieve all GitHub codes of conduct. Call this tool to get a list of all codes of conduct available on GitHub. Useful for reviewing or selecting a code of conduct for a project.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'codes-of-conduct/get-all-codes-of-conduct'.
#

GithubApi.GetAllowedActionsForEnterprise

Retrieve the actions allowed in a GitHub enterprise. This tool gets the selected actions permitted in a specified enterprise. The enterprise's permission policy must be configured to allow selected actions. Authentication with an access token having the `admin:enterprise` scope is required.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug version or ID of the enterprise to fetch allowed actions for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-allowed-actions-enterprise'.
#

GithubApi.GetAllowedActionsForOrganization

Retrieve the allowed GitHub Actions for an organization. Call this tool to get the list of selected GitHub Actions permitted for an organization, provided the organization policy is set to allow selected actions only. Requires an authenticated access token with `admin:org` scope or GitHub App with `administration` permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. This is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-allowed-actions-organization'.
#

GithubApi.GetAllowedActionsForRepo

Retrieve allowed GitHub Actions settings for a repository. Use this tool to fetch the settings for actions that are allowed in a GitHub repository. This is applicable when the repository's policy is set to `selected` for `allowed_actions`. Requires authentication with a token having `repo` scope or GitHub Apps with `administration` permission.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe username or organization name of the repository owner. Case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-allowed-actions-repository'.
#

GithubApi.GetAppsWithBranchAccess

Retrieve GitHub Apps with access to a protected branch. This tool lists the GitHub Apps that have push access to a specific protected branch. It should be called when you need to identify which installed GitHub Apps are authorized to interact with a branch under protection.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe name of the branch. Wildcard characters are not allowed; use exact names only.
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository, not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-apps-with-access-to-protected-branch'.
#

GithubApi.GetBranchAccessRestrictions

Retrieve access information for a protected branch. Use this tool to list users, apps, and teams with access to a specified protected branch within an organization-owned repository on GitHub. It provides details about who has permissions to interact with the branch.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe exact name of the branch to retrieve access information for. Wildcard characters are not allowed.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-access-restrictions'.
#

GithubApi.GetBranchProtectionStatusChecks

Retrieve status check protections for a GitHub branch. Use this tool to get information on the status check protections for a specific branch in a GitHub repository. It is useful for ensuring that a branch has the required checks before merging.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe name of the branch. It must not contain wildcard characters.
repository_namestringRequiredThe name of the GitHub repository to check. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-status-checks-protection'.
#

GithubApi.GetCodeOfConduct

Retrieve a specific code of conduct from GitHub. This tool retrieves the details of a specific code of conduct using its unique key from GitHub. It should be called when you need information about a particular community guideline.

Parameters

ParameterTypeReq.Description
conduct_code_keystringRequiredThe unique identifier for the specific code of conduct you want to retrieve.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'codes-of-conduct/get-conduct-code'.
#

GithubApi.GetCodeScanningAlert

Retrieve a single code scanning alert from a GitHub repo. Use this tool to get detailed information about a specific code scanning alert in a GitHub repository. An access token with appropriate scopes is required for private repositories, and GitHub Apps need read permission for security events.

Parameters

ParameterTypeReq.Description
alert_numberintegerRequiredThe unique number identifying a specific code scanning alert on GitHub. Found at the end of the URL for an alert or in the `number` field from the `GET /repos/{owner}/{repo}/code-scanning/alerts` response.
repository_namestringRequiredThe name of the repository. This parameter is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'code-scanning/get-alert'.
#

GithubApi.GetCodeScanningAnalysis

Retrieve detailed code scanning analysis for a GitHub repository. Use this tool to access a specific code scanning analysis for a GitHub repository, including information such as the Git reference, commit SHA, analysis datetime, code scanning tool name, and the number of alerts. It requires appropriate permissions for both private and public repositories.

Parameters

ParameterTypeReq.Description
analysis_idintegerRequiredThe ID number of the code scanning analysis to retrieve for the repository. This ID is obtained from the `GET /repos/{owner}/{repo}/code-scanning/analyses` operation.
repository_namestringRequiredThe name of the GitHub repository. The name is not case sensitive.
repository_ownerstringRequiredSpecify the account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'code-scanning/get-analysis'.
#

GithubApi.GetCombinedCommitStatus

Retrieve the combined status of a commit for a given reference. This tool provides a combined view of commit statuses for a specified reference (SHA, branch, or tag) in a GitHub repository. It is useful for users with pull access who need to verify the overall status of a commit, including whether it is in a 'failure', 'pending', or 'success' state.

Parameters

ParameterTypeReq.Description
reference_specifierstringRequiredThe ref parameter specifying the SHA, branch name, or tag name for the commit status.
repository_namestringRequiredThe name of the repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is a case-insensitive string.
results_page_numberintegerOptionalThe page number of commit status results to fetch. Useful for pagination.
results_per_pageintegerOptionalThe number of results to include per page, with a maximum limit of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-combined-status-for-ref'.
#

GithubApi.GetCommentStatistics

Retrieve comment statistics from GitHub Enterprise. Use this tool to get detailed statistics about comments in a GitHub Enterprise instance. Useful for analyzing comment activity and engagement across repositories.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-comment-stats'.
#

GithubApi.GetCommitActivity

Fetch yearly commit activity grouped by week. Use this tool to obtain commit activity statistics for a GitHub repository over the past year, categorized by week. Useful for analyzing commit trends and activity levels.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This value is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-commit-activity-stats'.
#

GithubApi.GetCommitActivityByHour

Retrieve commit activity per hour for a GitHub repository. Provides an array with commit activity stats showing the day of the week, hour of the day, and the number of commits for each hour in a specific GitHub repository. Useful for analyzing commit patterns and identifying peak development times.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository to analyze. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository; this is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-punch-card-stats'.
#

GithubApi.GetCommitDetails

Retrieve details of a single commit reference. Fetches full details of a specific commit from a repository, including verification status, file diffs, and commit metadata. Useful for checking commit history, signature verification, and differences. Accessing this information requires 'read' access to the repository.

Parameters

ParameterTypeReq.Description
commit_referencestringRequiredThe reference string (branch name, tag, or commit SHA) for the commit to fetch details about.
repository_namestringRequiredThe name of the repository. This is not case sensitive and required to identify the repository from which to fetch commit details.
repository_ownerstringRequiredThe account owner of the repository, not case sensitive.
results_page_numberintegerOptionalThe page number of the commit results to fetch from the API. Use for pagination.
results_per_pageintegerOptionalSpecify the number of results to return per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-commit'.
#

GithubApi.GetCommitStatuses

Retrieve commit statuses for a specific ref in a repository. Call this tool to get the statuses of commits for a specific ref (SHA, branch, or tag) in a GitHub repository. Useful for checking build or test statuses and integrations that provide feedback on commits.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe GitHub username or organization name that owns the repository. This is not case sensitive.
repository_referencestringRequiredThe reference for the commit, which can be a SHA, branch name, or tag name. It specifies the ref to fetch statuses for in the repository.
results_page_numberintegerOptionalThe page number to fetch the results from, useful for pagination.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-commit-statuses-for-ref'.
#

GithubApi.GetCommonlyUsedLicenses

Fetch a list of commonly used software licenses. Retrieves a collection of the most commonly used open-source software licenses from GitHub.

Parameters

ParameterTypeReq.Description
only_featured_licensesbooleanOptionalSet to true to return only featured licenses.
results_page_numberintegerOptionalPage number of the results to fetch. Use to navigate through pages of results.
results_per_pageintegerOptionalSpecify the number of licenses to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'licenses/get-all-commonly-used'.
#

GithubApi.GetDefaultGithubActionsPermissions

Retrieve default GitHub Actions workflow permissions for a repository. This tool retrieves the default workflow permissions associated with the `GITHUB_TOKEN` in a specific GitHub repository. It also checks if GitHub Actions can submit approving pull request reviews for that repository. Authentication with an access token having the `repo` scope is required.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository, which is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-github-actions-default-workflow-permissions-repository'.
#

GithubApi.GetDefaultGithubActionsWorkflowPermissions

Fetches default workflow permissions for an organization's GitHub Actions. This tool retrieves the default workflow permissions granted to the GITHUB_TOKEN for running workflows in a specified organization, and checks if GitHub Actions can submit approving pull request reviews. Requires authentication with an access token having 'admin:org' scope or 'administration' permission for GitHub Apps.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe organization name for which to fetch the workflow permissions. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-github-actions-default-workflow-permissions-organization'.
#

GithubApi.GetDependabotAlert

Retrieve details of a specific Dependabot alert. Use this tool to get information about a specific Dependabot alert in a GitHub repository. Applicable for both private and public repositories, depending on token scope.

Parameters

ParameterTypeReq.Description
dependabot_alert_numberintegerRequiredThe identifier number for the Dependabot alert in the repository. Obtainable from the alert URL or response from `GET /repos/{owner}/{repo}/dependabot/alerts`.
repository_namestringRequiredThe name of the repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/get-alert'.
#

GithubApi.GetDeploymentBranchPolicy

Retrieve deployment branch policy for a specific environment. Use this tool to get the deployment branch policy for a specific environment in a GitHub repository. Requires read access to the repository. For private repositories, an access token with the `repo` scope is needed. GitHub Apps need `actions:read` permission.

Parameters

ParameterTypeReq.Description
branch_policy_identifierintegerRequiredThe unique identifier of the branch policy in the environment. Should be an integer value.
environment_namestringRequiredThe name of the environment for which the deployment branch policy is being retrieved.
repository_namestringRequiredThe name of the repository. Not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. This is case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-deployment-branch-policy'.
#

GithubApi.GetEnterpriseAnnouncementBanner

Retrieve the global announcement banner for your enterprise. This tool fetches the current message and expiration date of the global announcement banner in your enterprise on GitHub. It is useful for administrators who need to check or display the announcement details.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-announcement'.
#

GithubApi.GetEnterpriseAuditLog

Retrieve the audit log for a specified enterprise. This tool fetches the audit log for an enterprise on GitHub. It is intended for use by enterprise admins with proper access rights. The audit log provides insights into various activities and changes within the enterprise.

Parameters

ParameterTypeReq.Description
enterprise_slug_or_idstringRequiredThe slug or ID of the enterprise to fetch the audit log for. Either the slug version of the enterprise name or the enterprise ID can be used.
after_cursorstringOptionalA cursor from the Link header to search for events after this point.
audit_log_event_orderstringOptionalSpecify 'desc' for newest events first or 'asc' for oldest events first. Default is 'desc'.
event_types_to_includestringOptionalSpecify event types to include: 'web' for web events, 'git' for Git events, or 'all' for both. Defaults to 'web'.
result_page_numberintegerOptionalThe page number of audit log results to fetch.
results_per_pageintegerOptionalSpecify the number of results to display per page, with a maximum limit of 100.
search_events_before_cursorstringOptionalA cursor to filter events occurring before the specified position in the audit log.
search_phrasestringOptionalA search phrase to filter audit log entries. Refer to [GitHub Docs](https://docs.github.com/enterprise-server@3.8/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/searching-the-audit-log-for-your-enterprise#searching-the-audit-log) for more details.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-audit-log'.
#

GithubApi.GetEnvironmentSecretInfo

Retrieve details of an environment secret on GitHub. Fetches metadata about a specific GitHub environment secret. This tool is useful for getting information like the name and existence of a secret without revealing its encrypted value. Authentication with a token having `repo` scope or `secrets` permission is required.

Parameters

ParameterTypeReq.Description
environment_namestringRequiredThe name of the environment to access the secret from. Required to specify which environment's secret details to retrieve.
repository_idintegerRequiredThe unique identifier of the GitHub repository.
secret_namestringRequiredThe name of the environment secret to retrieve information about.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-environment-secret'.
#

GithubApi.GetGistComment

Retrieve a specific comment from a GitHub gist. Use this tool to obtain details about a specific comment on a GitHub gist using the gist and comment IDs.

Parameters

ParameterTypeReq.Description
comment_idintegerRequiredUnique identifier for the gist comment to retrieve details for.
gist_unique_idstringRequiredThe unique identifier for the gist needed to retrieve a specific comment.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/get-comment'.
#

GithubApi.GetGistRevision

Retrieve a specific revision of a GitHub gist. Use this tool to get details about a specific revision of a GitHub gist using the gist ID and SHA.

Parameters

ParameterTypeReq.Description
gist_identifierstringRequiredThe unique identifier of the GitHub gist to retrieve a specific revision.
revision_shastringRequiredThe SHA hash of the specific gist revision to retrieve.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/get-revision'.
#

GithubApi.GetGitGistStatistics

Retrieve gist statistics from GitHub Enterprise. Use this tool to obtain statistics for gists from GitHub Enterprise. It should be called when you need detailed data about gists usage and distribution.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-gist-stats'.
#

GithubApi.GetGithubActionsCachePolicy

Retrieve the GitHub Actions cache usage policy for an enterprise. Fetches the cache usage policy for GitHub Actions associated with a specific enterprise. Requires authentication with an access token that has the `admin:enterprise` scope or a GitHub App with the `enterprise_administration:write` permission.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug version or ID of the enterprise for GitHub Actions cache policy retrieval.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-actions-cache-usage-policy-for-enterprise'.
#

GithubApi.GetGithubActionsCacheUsage

Fetch GitHub Actions cache usage for a repository. Use this tool to get the current cache usage for GitHub Actions in a specific repository. Cache data is updated approximately every 5 minutes. Requires read access to the repository and appropriate permissions for private repositories.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Case insensitive name.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-actions-cache-usage'.
#

GithubApi.GetGithubActionsCacheUsageForEnterprise

Retrieve GitHub Actions cache usage for an enterprise. Fetches the total cache usage for GitHub Actions in a specified enterprise. Useful for monitoring and managing enterprise-level actions resources. The data is refreshed every 5 minutes and requires an access token with the 'admin:enterprise' scope for authentication.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID of the enterprise. Can be either the enterprise name in slug format or the enterprise ID.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-actions-cache-usage-for-enterprise'.
#

GithubApi.GetGithubActionsCacheUsageForOrg

Retrieve GitHub Actions cache usage for an organization's repositories. Use this tool to get a list of repositories and their GitHub Actions cache usage for a specified organization. The data is refreshed every 5 minutes. Requires authentication with an access token with the `read:org` scope or a GitHub App with `organization_administration:read` permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization to retrieve cache usage for. This is not case sensitive.
page_numberintegerOptionalSpecify the page number of the results to fetch. This is useful for paginated data retrieval.
results_per_pageintegerOptionalThe number of results to return per page, with a maximum of 100 entries.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-actions-cache-usage-by-repo-for-org'.
#

GithubApi.GetGithubActionsPermissions

Get GitHub Actions permissions for an enterprise. Retrieve the GitHub Actions permissions policy and allowed actions for organizations within a specified enterprise. Requires authentication with an access token that has the `admin:enterprise` scope.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredIdentifier for the enterprise, either as a slug version of the name or the enterprise ID.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-github-actions-permissions-enterprise'.
#

GithubApi.GetGithubActionsPermissionsForOrganization

Retrieve GitHub Actions permissions for an organization. Fetches the GitHub Actions permissions policy for repositories and allowed actions within a specified organization. Requires authentication with an access token having the `admin:org` scope or a GitHub App with `administration` organization permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe organization name for which to retrieve GitHub Actions permissions. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-github-actions-permissions-organization'.
#

GithubApi.GetGithubActionsRunReviews

Retrieve reviews for a GitHub Actions run. Call this tool to get reviews and approval details for a specific GitHub Actions run in a repository. It requires an access token with `repo` scope for private repositories or `actions:read` permission for GitHub Apps.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. The input is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Not case sensitive.
workflow_run_idintegerRequiredThe unique identifier of the GitHub Actions workflow run. This integer is required to fetch the reviews.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-reviews-for-run'.
#

GithubApi.GetGithubAppDetailsBySlug

Retrieve GitHub App details using its slug. Use this tool to obtain details about a GitHub App by providing its URL-friendly slug. This can be accessed without authentication for public apps, but requires authentication for private ones using a personal or installation access token.

Parameters

ParameterTypeReq.Description
github_app_slugstringRequiredThe URL-friendly name of the GitHub App to retrieve details for. Found on the GitHub App settings page.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/get-by-slug'.
#

GithubApi.GetGithubAppInfo

Retrieve details about the authenticated GitHub App. This tool returns information about the GitHub App associated with the authentication credentials. It provides details such as the number of installations linked to the app. It's useful to check app configuration and installation status.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/get-authenticated'.
#

GithubApi.GetGithubAppInstallationInfo

Fetch information of a GitHub App installation by ID. Use this tool to retrieve detailed information about a specific GitHub App installation using its installation ID. Useful for scenarios where you need to know the configuration or settings of a particular installation.

Parameters

ParameterTypeReq.Description
installation_idintegerRequiredThe unique identifier of the GitHub App installation to fetch information for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/get-installation'.
#

GithubApi.GetGithubAppInstallations

Retrieve GitHub App installations for the authenticated user. Lists GitHub App installations that the authenticated user can access with permissions such as `:read`, `:write`, or `:admin`. This requires a user-to-server OAuth access token, valid for a user who authorized the app. Useful for accessing repositories owned, collaborated on, or accessible through organization membership.

Parameters

ParameterTypeReq.Description
results_page_numberintegerOptionalPage number of the results to fetch for GitHub App installations.
results_per_pageintegerOptionalSpecifies the number of results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/list-installations-for-authenticated-user'.
#

GithubApi.GetGithubAppRepoInstallation

Fetches GitHub App installation info for a repository. Use this tool to get the installation information of a GitHub App for a specific repository. The installation can belong to an organization or user account, depending on the repository's owner.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. It is not case sensitive and identifies the specific repository for which to retrieve GitHub App installation information.
repository_ownerstringRequiredThe account owner's name for the repository, not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/get-repo-installation'.
#

GithubApi.GetGithubAppWebhookConfig

Fetches the webhook configuration for a GitHub App. This tool retrieves the webhook configuration details for a specific GitHub App. It should be called when you need to review or manage the webhook settings of your GitHub App. Note that access requires authentication using a JWT.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/get-webhook-config-for-app'.
#

GithubApi.GetGithubAppWebhookDelivery

Retrieve delivery details for a GitHub App webhook. Fetches the delivery information for a specific webhook configured in a GitHub App. This tool should be called when you need to obtain details about a specific delivery event linked to a webhook. Ensure you are authenticated with a JWT to access this information.

Parameters

ParameterTypeReq.Description
webhook_delivery_idintegerRequiredThe ID of the webhook delivery to retrieve. Must be an integer.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/get-webhook-delivery'.
#

GithubApi.GetGithubArtifactDownloadUrl

Retrieve a URL to download a GitHub artifact zip file. Use this tool to get a redirect URL for downloading an artifact zip file from a GitHub repository. The URL is valid for 1 minute and requires read access to the repository. For private repositories, an access token with the 'repo' scope is needed. This tool is useful for automating the retrieval of artifact files from GitHub Actions.

Parameters

ParameterTypeReq.Description
archive_format_zipstringRequiredSpecify the archive format as 'zip'. This is required for the download link.
artifact_idintegerRequiredThe unique identifier of the artifact to be downloaded.
repository_namestringRequiredThe name of the GitHub repository (not case sensitive).
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/download-artifact'.
#

GithubApi.GetGithubBlobContent

Retrieve Base64 encoded content of a GitHub blob. Use this tool to fetch the content of a blob from a GitHub repository. It is useful for accessing file contents stored in GitHub in a Base64 encoded format. This tool supports blobs up to 100 megabytes.

Parameters

ParameterTypeReq.Description
file_sha_identifierstringRequiredThe SHA identifier for the blob. This is used to access the specific file blob from the GitHub repository.
repository_namestringRequiredThe name of the GitHub repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'git/get-blob'.
#

GithubApi.GetGithubBranchProtection

Retrieve protection settings for a GitHub branch. Use this tool to obtain protection settings for a specific branch in a GitHub repository. This is useful for understanding the rules and restrictions applied to the branch, including who can push changes or enforce specific merge rules.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe specific name of the GitHub branch to retrieve protection settings for. Must not contain wildcard characters.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-branch-protection'.
#

GithubApi.GetGithubCheckRun

Retrieve a specific GitHub check run by its ID. Use this tool to get details of a single check run from a GitHub repository using its ID. This is applicable for both private and public repositories, with necessary permissions.

Parameters

ParameterTypeReq.Description
check_run_identifierintegerRequiredThe unique identifier of the GitHub check run to retrieve.
repository_namestringRequiredThe name of the GitHub repository, not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'checks/get'.
#

GithubApi.GetGithubCheckSuite

Retrieve a GitHub check suite by ID. Use this tool to get information about a specific check suite in a GitHub repository using its ID. Suitable for users with appropriate permissions on private or public repositories.

Parameters

ParameterTypeReq.Description
check_suite_idintegerRequiredThe unique identifier for the GitHub check suite to retrieve.
repository_namestringRequiredThe name of the repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'checks/get-suite'.
#

GithubApi.GetGithubCommitComment

Retrieve details of a specific commit comment on GitHub. Use this tool to get detailed information about a specific commit comment in a GitHub repository, identified by the owner, repository name, and comment ID.

Parameters

ParameterTypeReq.Description
comment_identifierintegerRequiredThe unique identifier for the GitHub commit comment to be retrieved.
repository_namestringRequiredThe name of the repository. This value is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-commit-comment'.
#

GithubApi.GetGithubContributorStats

Retrieve GitHub repository contributor statistics. Fetches the total number of commits made by each contributor to a GitHub repository. It also provides a weekly breakdown of additions, deletions, and commits.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case-sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. This is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-contributors-stats'.
#

GithubApi.GetGithubDeployKey

Retrieve a deploy key from a GitHub repository. This tool retrieves the details of a specific deploy key associated with a GitHub repository. It should be used when you need to access information about a deploy key for a specified repository and key ID.

Parameters

ParameterTypeReq.Description
deploy_key_idintegerRequiredThe unique identifier of the deploy key to retrieve from the repository.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-deploy-key'.
#

GithubApi.GetGithubDeploymentStatus

Retrieve details of a specific GitHub deployment. Call this tool to get information about a particular deployment in a GitHub repository, including its status and other related details.

Parameters

ParameterTypeReq.Description
deployment_idintegerRequiredThe unique identifier for the deployment to retrieve details about.
repository_namestringRequiredThe name of the GitHub repository, not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-deployment'.
#

GithubApi.GetGithubEnterpriseMetaInfo

Retrieve GitHub Enterprise Server meta information. This tool is used to obtain meta information about a GitHub Enterprise Server. It should be called when details about the server's configuration and capabilities are needed.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'meta/get'.
#

GithubApi.GetGithubEnterpriseSettings

Retrieve the current settings of your GitHub Enterprise instance.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-settings'.
#

GithubApi.GetGithubEnterpriseStats

Retrieve all statistics for GitHub Enterprise. This tool fetches comprehensive statistics related to GitHub Enterprise. It should be used when you need detailed operational insights into the GitHub Enterprise environment.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-all-stats'.
#

GithubApi.GetGithubEnvironmentPublicKey

Fetch the public key for a GitHub environment. This tool retrieves the public key needed to encrypt environment secrets for a specified GitHub repository and environment. Use it when you need to secure secrets before creating or updating them. Requires appropriate access permissions.

Parameters

ParameterTypeReq.Description
environment_namestringRequiredThe name of the GitHub environment for which to retrieve the public key.
repository_idintegerRequiredThe unique identifier of the GitHub repository. It must be an integer value.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-environment-public-key'.
#

GithubApi.GetGithubEnvVariable

Retrieve specific environment variable details from GitHub. Call this tool to get information about a specific environment variable within a specified environment of a GitHub repository. Requires authentication with an access token having 'repo' scope or GitHub App permissions.

Parameters

ParameterTypeReq.Description
environment_namestringRequiredThe name of the environment to retrieve the variable from. Required for identifying the specific environment.
repository_idintegerRequiredThe unique identifier of the GitHub repository.
variable_namestringRequiredThe name of the environment variable to retrieve from the GitHub repository.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-environment-variable'.
#

GithubApi.GetGithubExternalGroupInfo

Retrieve information about a GitHub external group's usage. This tool displays information about a specific external group's usage within a GitHub organization. It provides details on the group's external members and the teams connected to this group. Useful for managing team membership through identity providers using Enterprise Managed Users for GitHub Enterprise Cloud.

Parameters

ParameterTypeReq.Description
group_idintegerRequiredThe unique identifier of the group. Must be an integer.
organization_namestringRequiredThe name of the GitHub organization. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/external-idp-group-info-for-org'.
#

GithubApi.GetGithubFeeds

Retrieve available GitHub feeds for an authenticated user. This tool retrieves a list of timeline resources available on GitHub Enterprise Server in Atom format. It includes global public timelines, public and private timelines for users, private timelines for user activities and organizations, and security advisories. Private feeds require Basic Auth for retrieval.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/get-feeds'.
#

GithubApi.GetGithubGist

Retrieve details of a specific GitHub gist using its ID. Use this tool to obtain information about a particular GitHub gist by providing the gist ID. It is helpful when you need to access the content, description, or other metadata of a GitHub gist.

Parameters

ParameterTypeReq.Description
gist_identifierstringRequiredThe unique identifier for the GitHub gist you want to retrieve.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/get'.
#

GithubApi.GetGithubGlobalWebhook

Retrieve details of a specific global webhook in GitHub Enterprise. Use this tool to obtain detailed information about a specific global webhook in a GitHub Enterprise setup by providing the hook ID.

Parameters

ParameterTypeReq.Description
global_webhook_idintegerRequiredThe unique identifier for the global webhook in GitHub Enterprise. Provide this ID to retrieve specific webhook details.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-global-webhook'.
#

GithubApi.GetGithubIssueComment

Retrieve a comment from a GitHub issue. Use this tool to obtain detailed information about a specific comment on an issue within a GitHub repository. It requires specifying the repository owner, repository name, and comment ID.

Parameters

ParameterTypeReq.Description
comment_identifierintegerRequiredThe unique integer identifier for the GitHub issue comment.
repository_namestringRequiredThe name of the repository. It is not case sensitive and is required to identify the repository within an account.
repository_ownerstringRequiredThe account owner of the repository on GitHub. This is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/get-comment'.
#

GithubApi.GetGithubIssueDetails

Fetch details of a specific issue or pull request on GitHub. Use this tool to retrieve information about a particular issue or pull request from a GitHub repository. This tool returns a 301 status if the issue was transferred, 404 if inaccessible or deleted, and 410 if deleted but accessible. Pull requests are also considered issues and can be identified by the 'pull_request' key in the response.

Parameters

ParameterTypeReq.Description
issue_identifierintegerRequiredThe unique number that identifies the issue or pull request on GitHub.
repository_namestringRequiredThe name of the GitHub repository. This is not case sensitive.
repository_ownerstringRequiredThe GitHub username of the repository owner. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/get'.
#

GithubApi.GetGithubIssueStatistics

Retrieve statistics on GitHub issues for an enterprise. This tool fetches statistical data related to issues in a GitHub enterprise account. It should be called when you need insights on issue counts, trends, or other related metrics.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-issue-stats'.
#

GithubApi.GetGithubLabel

Retrieve details of a GitHub repository label. Call this tool to get information about a specific label from a GitHub repository, including its details and specifications.

Parameters

ParameterTypeReq.Description
label_namestringRequiredThe specific name of the label to retrieve from the GitHub repository.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. Not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/get-label'.
#

GithubApi.GetGithubLicense

Retrieve a specific GitHub license by its key. Use this tool to get details about a specific license on GitHub by specifying its key. Useful when you need information about license terms and conditions for a repository.

Parameters

ParameterTypeReq.Description
license_keystringRequiredThe key of the GitHub license to retrieve information about.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'licenses/get'.
#

GithubApi.GetGithubMilestone

Retrieve details of a GitHub milestone for a repository. This tool is used to obtain information about a specific milestone in a GitHub repository. It should be called when you need to access details such as the milestone's due date, description, or state.

Parameters

ParameterTypeReq.Description
milestone_idintegerRequiredThe unique number identifying the milestone to retrieve details from a GitHub repository.
repository_namestringRequiredThe name of the repository for which the milestone information is needed. This name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/get-milestone'.
#

GithubApi.GetGithubNotificationThread

Retrieve information about a GitHub notification thread. Use this tool to get detailed information about a specific notification thread on GitHub. It's helpful for users who need to track updates or manage their notifications.

Parameters

ParameterTypeReq.Description
notification_thread_idintegerRequiredThe unique identifier of the notification thread, returned in the `id` field when retrieving notifications.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/get-thread'.
#

GithubApi.GetGithubOrgInfo

Retrieve detailed information about a GitHub organization. This tool retrieves information about a specific GitHub organization, such as its plan and two-factor authentication requirements. It requires authentication as an organization owner or a GitHub App with the appropriate permissions.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization to retrieve information for. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/get'.
#

GithubApi.GetGithubOrgInstallationInfo

Retrieve GitHub organization's installation information. Use this tool to find installation details for an organization using an authenticated GitHub App. It requires a JWT for access.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name. It is not case-sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/get-org-installation'.
#

GithubApi.GetGithubOrgSecret

Retrieve details of a GitHub organization secret. Use this tool to get the details of a GitHub organization secret without exposing its encrypted value. Authentication with an access token with `admin:org` scope or GitHub App with `secrets` permission is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name. This name is not case sensitive.
secret_namestringRequiredThe name of the secret within the GitHub organization. It identifies which secret's details to retrieve.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-org-secret'.
#

GithubApi.GetGithubOrgStats

Retrieve organization statistics from GitHub Enterprise. Use this tool to get detailed statistics about organizations in a GitHub Enterprise setup. It's useful for monitoring and analyzing organizational data.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-org-stats'.
#

GithubApi.GetGithubPagesBuild

Retrieve details of a GitHub Pages build for a repository. Use this tool to get information about a specific GitHub Pages build in a repository on GitHub Enterprise Server. It requires the repository owner, repository name, and build ID to fetch the details.

Parameters

ParameterTypeReq.Description
build_identifierintegerRequiredThe unique identifier for the GitHub Pages build.
repository_namestringRequiredThe name of the repository. This field is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-pages-build'.
#

GithubApi.GetGithubPagesSite

Retrieve details of a GitHub Pages site for a repository. This tool is used to get information about a GitHub Pages site for a specified repository on GitHub Enterprise Server. It should be called when you need details about the Pages site configuration or status for a given repository.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. Not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-pages'.
#

GithubApi.GetGithubPagesStats

Retrieve statistics for GitHub Pages in an enterprise account. Use this tool to obtain detailed statistics about GitHub Pages usage and performance within an enterprise account.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-pages-stats'.
#

GithubApi.GetGithubPreReceiveEnvironment

Retrieve a GitHub pre-receive environment by ID. Use this tool to get detailed information about a specific pre-receive environment in GitHub for enterprise administration purposes.

Parameters

ParameterTypeReq.Description
pre_receive_environment_idintegerRequiredThe unique identifier for the GitHub pre-receive environment.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-pre-receive-environment'.
#

GithubApi.GetGithubProjectById

Retrieve details of a GitHub project by its ID. Call this tool to obtain information about a specific GitHub project using its ID. It provides project details if accessible or returns an appropriate error status if there are issues like insufficient privileges or if projects are disabled.

Parameters

ParameterTypeReq.Description
project_idintegerRequiredThe unique identifier for the GitHub project to retrieve.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/get'.
#

GithubApi.GetGithubProjectColumn

Retrieve details of a GitHub project column using its ID. Use this tool to obtain information about a specific column in a GitHub project. It should be called when you need to access the details of a project column using its column ID.

Parameters

ParameterTypeReq.Description
project_column_idintegerRequiredThe unique identifier for the project column to retrieve.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/get-column'.
#

GithubApi.GetGithubRateLimit

Retrieve current GitHub API rate limit status. Use this tool to check the current API rate limit status on GitHub. It provides information on the remaining requests allowed in the current rate limit window without affecting your API usage.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'rate-limit/get'.
#

GithubApi.GetGithubReleaseByTag

Retrieve GitHub release details by tag. Use this tool to get details of a published GitHub release using the specified repository owner, repository name, and release tag.

Parameters

ParameterTypeReq.Description
release_tagstringRequiredThe specific tag of the release to retrieve. This is used to identify and fetch details of the published release.
repository_namestringRequiredSpecify the name of the repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive. Provide the GitHub username or organization name.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-release-by-tag'.
#

GithubApi.GetGithubReleaseDetails

Retrieve details of a specific GitHub release. Use this tool to obtain details about a specific release from a GitHub repository. This includes the upload URL for release assets, which is a hypermedia resource.

Parameters

ParameterTypeReq.Description
release_idintegerRequiredThe unique identifier for the specific GitHub release being queried.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-release'.
#

GithubApi.GetGithubReleases

Retrieve a list of releases for a GitHub repository. Use this tool to get a list of releases from a specific GitHub repository. Note that this list will only include releases, not regular Git tags. Draft releases will be listed only if the user has push access to the repository. This tool is useful for accessing information about software releases available on GitHub.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. Case insensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. The name is not case sensitive.
results_page_numberintegerOptionalThe specific page number of releases to fetch from a repository.
results_per_pageintegerOptionalSpecify the number of release results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-releases'.
#

GithubApi.GetGithubRepoBranch

Retrieve details of a specific branch from a GitHub repository. Use this tool to obtain information about a particular branch within a specified GitHub repository. Provide the owner, repository name, and branch name to get the branch details.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe name of the GitHub branch. Avoid using wildcard characters. For wildcard support, refer to the GitHub GraphQL API.
repository_namestringRequiredThe name of the GitHub repository (case-insensitive).
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-branch'.
#

GithubApi.GetGithubRepoContent

Retrieve file or directory contents from a GitHub repository. Use this tool to get the contents of a specified file or directory in a GitHub repository. By specifying the file path or directory, you can fetch the required information. If no path is specified, the root directory contents are retrieved. It supports custom media types for raw or HTML content. Note that files larger than 100 MB are not supported.

Parameters

ParameterTypeReq.Description
file_or_directory_pathstringRequiredThe file or directory path within the repository. If omitted, the root directory is accessed.
repository_namestringRequiredThe name of the GitHub repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This value is not case sensitive.
commit_branch_or_tagstringOptionalThe name of the commit, branch, or tag to retrieve content from. Defaults to the repository's default branch, usually 'master'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-content'.
#

GithubApi.GetGithubRepoEnvironmentDetails

Retrieve details about a GitHub repository environment. Use this tool to get information on a specified environment within a GitHub repository. This can be used by anyone with read access to the repository. Access tokens with the 'repo' scope are required for private repositories, and GitHub Apps need 'actions:read' permission.

Parameters

ParameterTypeReq.Description
environment_namestringRequiredThe name of the environment to retrieve details for. It is case insensitive.
repository_namestringRequiredThe name of the GitHub repository (not case sensitive).
repository_owner_account_namestringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-environment'.
#

GithubApi.GetGithubRepoPublicKey

Retrieve the public key for encrypting repository secrets. Use this tool to obtain the public key needed for encrypting secrets before creating or updating them in a GitHub repository. It can be accessed by anyone with read access to the repository. For private repositories, an access token with the `repo` scope is required. GitHub Apps need the `dependabot_secrets` repository permission.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository, not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/get-repo-public-key'.
#

GithubApi.GetGithubRepoRequiredWorkflow

Retrieve a specific required workflow from a GitHub repository. This tool fetches details of a required workflow from a specified GitHub repository. It can be used by anyone with read access to the repository. For private repositories, an access token with the 'repo' scope is needed. Useful for managing and auditing workflows in GitHub repositories.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
required_workflow_idintegerRequiredThe unique ID of the required workflow that has executed at least once in the repository.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-repo-required-workflow'.
#

GithubApi.GetGithubRepositoryDetails

Retrieve detailed information about a GitHub repository. This tool retrieves detailed information about a specified GitHub repository. It provides details such as the parent and source repositories if the repository is a fork. Admin or owner permissions might be required to access certain security details.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. This is not case sensitive.
repository_ownerstringRequiredSpecify the account owner of the repository. This name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get'.
#

GithubApi.GetGithubRepoVariable

Retrieve a specific variable from a GitHub repository. This tool retrieves information about a specific variable within a GitHub repository. It's useful when you need to access configuration or environment variables stored in a repository. Authentication with an access token having the `repo` scope is required, or GitHub Apps must have the `actions_variables:read` permission.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
variable_namestringRequiredThe name of the variable to retrieve from the repository. This is case-sensitive and must match the variable's exact name.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-repo-variable'.
#

GithubApi.GetGithubReview

Retrieve details of a specific pull request review from GitHub. Use this tool to obtain a review for a specific pull request by providing the repository owner, repository name, pull request number, and review ID.

Parameters

ParameterTypeReq.Description
pull_request_numberintegerRequiredThe unique number identifying the pull request on GitHub.
repository_namestringRequiredThe name of the GitHub repository. This field is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. It is not case sensitive.
review_idintegerRequiredThe unique numeric identifier for the specific review of the pull request.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/get-review'.
#

GithubApi.GetGithubReviewCommentDetails

Get details for a specific GitHub review comment. Call this tool to obtain detailed information about a specific review comment on a GitHub pull request, such as the content, author, and creation time.

Parameters

ParameterTypeReq.Description
comment_idintegerRequiredThe unique identifier of the GitHub review comment you want to retrieve details for.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This value is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/get-review-comment'.
#

GithubApi.GetGithubSecretScanningAlert

Retrieve a specific secret scanning alert from a GitHub repository. Use this tool to obtain details of a secret scanning alert detected in a GitHub repository. This requires administrative access to the repository or organization, and an appropriate personal access token. It also supports GitHub Apps with specific read permissions.

Parameters

ParameterTypeReq.Description
alert_identifierintegerRequiredThe unique integer number identifying a GitHub secret scanning alert. This is found at the URL's end for the alert or in the `number` field of the alert response.
repository_namestringRequiredThe case-insensitive name of the repository from which to retrieve the secret scanning alert.
repository_ownerstringRequiredThe username of the account owner for the repository. Case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'secret-scanning/get-alert'.
#

GithubApi.GetGithubSecurityBillingInfo

Retrieve GitHub Advanced Security billing details for an enterprise. This tool retrieves data on active committers using GitHub Advanced Security for an enterprise, listed per repository. It provides information on the number of distinct user logins and the total repositories with committer information.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID representing the enterprise name for security billing info.
results_page_numberintegerOptionalSpecify the page number of results to fetch. Use to navigate through paginated data.
results_per_pageintegerOptionalThe number of results per page to return. Maximum is 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'billing/get-github-advanced-security-billing-ghe'.
#

GithubApi.GetGithubStatusCheckContexts

Retrieve status check contexts for a protected GitHub branch. This tool fetches all status check contexts for a specific protected branch in a GitHub repository. Useful for understanding the checks required for branch protections. Suitable for repositories with branch protection enabled.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe name of the branch. Cannot include wildcard characters.
repository_namestringRequiredThe name of the GitHub repository. This value is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-all-status-check-contexts'.
#

GithubApi.GetGithubTeamDiscussionComment

Retrieve a specific comment from a GitHub team discussion. Use this tool to get details of a specific comment within a team discussion on GitHub. This is useful for accessing detailed information about comments in organizational discussions. Ensure OAuth tokens have the `read:discussion` scope.

Parameters

ParameterTypeReq.Description
comment_identifierintegerRequiredThe specific number identifying the comment in the discussion.
discussion_idintegerRequiredThe unique number identifying the specific discussion on GitHub.
organization_namestringRequiredThe name of the GitHub organization. This is not case sensitive.
team_slugstringRequiredThe slug (URL-friendly version) of the GitHub team's name. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/get-discussion-comment-in-org'.
#

GithubApi.GetGithubTokenWorkflowPermissions

Retrieve GitHub Actions default workflow permissions for an enterprise. This tool retrieves the default permissions for the `GITHUB_TOKEN` in workflows within a specified enterprise, including settings for pull request review approvals. Use this tool to understand and manage workflow access within your GitHub enterprise.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug version of the enterprise name or the enterprise ID.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-github-actions-default-workflow-permissions-enterprise'.
#

GithubApi.GetGithubUserHovercardInfo

Retrieve detailed hovercard info for a GitHub user. Fetches hovercard information about a specified GitHub user, offering insights related to their pull requests, issues, repositories, and organizations. Requires authentication through basic auth or OAuth with the `repo` scope. Enhanced details can be obtained by specifying `subject_type` and `subject_id` parameters.

Parameters

ParameterTypeReq.Description
github_usernamestringRequiredThe GitHub username for which to retrieve hovercard information.
additional_info_typestringOptionalSpecifies the type of related information for the user's hovercard. Options: `organization`, `repository`, `issue`, `pull_request`. Required with `subject_id`.
subject_identifierstringOptionalThe ID corresponding to the specified `subject_type` (e.g., organization, repository). Required if `subject_type` is used.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/get-context-for-user'.
#

GithubApi.GetGithubUserInfo

Fetch public details of a GitHub user using their username. This tool retrieves publicly available information about a GitHub user's account. It is useful for obtaining details such as username, profile information, and publicly visible email addresses if set by the user. Ideal for applications needing GitHub user data.

Parameters

ParameterTypeReq.Description
github_usernamestringRequiredThe GitHub user's handle. Used to fetch their public profile information.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/get-by-username'.
#

GithubApi.GetGithubUserInstallation

Retrieve a user's GitHub App installation information. Use to find installation details for a user authenticated with a GitHub App using a JWT.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe handle (username) of the GitHub user account to retrieve installation details for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/get-user-installation'.
#

GithubApi.GetGithubUserProfile

Retrieve authenticated user's GitHub profile information. Fetches public and private profile information for the authenticated GitHub user if authenticated with the `user` scope. Returns only public information otherwise.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/get-authenticated'.
#

GithubApi.GetGithubUserStats

Retrieve user statistics from GitHub Enterprise. This tool retrieves user statistics from a GitHub Enterprise instance. It should be called when needing detailed user data to analyze usage and activity metrics.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-user-stats'.
#

GithubApi.GetGithubWebhookDelivery

Retrieve a webhook delivery for a GitHub organization. This tool is used to obtain details about a specific delivery of a webhook configured in a GitHub organization. It provides information about the delivery for a given organization, hook, and delivery identifier.

Parameters

ParameterTypeReq.Description
hook_identifierintegerRequiredThe unique identifier of the webhook hook. This is an integer value used to specify which webhook's delivery details to retrieve for the organization.
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
webhook_delivery_idintegerRequiredThe unique identifier of the specific delivery to be retrieved. This should be an integer.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/get-webhook-delivery'.
#

GithubApi.GetGithubWorkflowJob

Retrieve a specific job from a GitHub workflow run. Use this tool to get details of a specific job from a GitHub workflow run. Requires read access to the repository. For private repositories, an access token with 'repo' scope is needed. GitHub Apps need 'actions:read' permission.

Parameters

ParameterTypeReq.Description
job_identifierintegerRequiredUnique integer identifier of the workflow job to retrieve.
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-job-for-workflow-run'.
#

GithubApi.GetGithubWorkflowRun

Retrieve details of a specific GitHub workflow run. Use this tool to get information about a specific workflow run on GitHub. It requires read access to the repository; for private repositories, an access token with `repo` scope is needed. Ideal for tracking and reviewing the status and details of a workflow run.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. It is not case sensitive and is used to identify the repo for the workflow run.
repository_ownerstringRequiredThe account owner of the repository, not case sensitive.
workflow_run_idintegerRequiredThe unique identifier of the GitHub workflow run. Must be an integer.
omit_pull_requestsbooleanOptionalIf true, omits pull requests from the response, resulting in an empty array.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-workflow-run'.
#

GithubApi.GetGithubWorkflowRunAttempt

Retrieve details of a specific GitHub workflow run attempt. Use this tool to access detailed information about a specific workflow run attempt in a GitHub repository. Accessible with repository read permissions. Requires an access token for private repositories.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository, not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This value is not case sensitive.
workflow_attempt_numberintegerRequiredThe numeric identifier for the specific attempt of the workflow run to be retrieved.
workflow_run_idintegerRequiredThe unique identifier of the GitHub workflow run. This integer specifies the exact run to retrieve information for.
omit_pull_requestsbooleanOptionalSet to true to omit pull requests from the response.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-workflow-run-attempt'.
#

GithubApi.GetGitReference

Fetch a specific Git reference from a repository. Use this tool to retrieve a branch or tag reference from a Git repository on GitHub. Input the specific branch or tag name formatted correctly to obtain the reference. Returns a 404 if the reference does not exist.

Parameters

ParameterTypeReq.Description
git_referencestringRequiredThe reference to the Git branch or tag, formatted as `heads/<branch name>` or `tags/<tag name>`.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'git/get-ref'.
#

GithubApi.GetGitTagSignatureVerification

Retrieve verification details of a git tag signature. This tool is used to get the verification details of a git tag's signature from a GitHub repository. It provides information about whether the signature is verified and the reason for the verification status.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. This value is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. This name is not case sensitive.
tag_shastringRequiredThe SHA hash identifier of the git tag to be verified. This should be a string.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'git/get-tag'.
#

GithubApi.GetGitTree

Fetch a git tree by its SHA1 value from a GitHub repo. Use this tool to retrieve a single tree structure from a GitHub repository using its SHA1 value. If the response indicates `truncated`, the tree array exceeds the maximum limit, requiring non-recursive methods for complete retrieval. This is useful for accessing specific parts of a repository's file structure.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. This is case-insensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
tree_shastringRequiredThe SHA1 value of the tree to fetch. This identifier is necessary to specify which tree structure should be retrieved from the repository.
enable_recursive_retrievalstringOptionalIf set, returns objects/subtrees referenced by the provided tree SHA. Use values: '0', '1', 'true', 'false'. Omit to disable recursion.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'git/get-tree'.
#

GithubApi.GetHooksStatistics

Retrieves statistics about enterprise webhooks on GitHub. Use this tool to obtain detailed statistics on webhook usage and performance within a GitHub Enterprise environment. It helps administrators monitor and analyze webhook activity.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-hooks-stats'.
#

GithubApi.GetIssueTimelineEvents

Retrieve timeline events for a GitHub issue. Use this tool to fetch and list all timeline events for a specific issue in a GitHub repository. It should be called when detailed event information about an issue's timeline is needed.

Parameters

ParameterTypeReq.Description
issue_identifierintegerRequiredThe unique number identifying the GitHub issue.
repository_namestringRequiredThe name of the repository in GitHub. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository, not case sensitive.
results_page_numberintegerOptionalPage number of results to fetch, used for pagination.
results_per_pageintegerOptionalSpecify the number of timeline events to retrieve per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/list-events-for-timeline'.
#

GithubApi.GetLatestGithubPagesBuild

Retrieve the latest GitHub Pages build information. This tool fetches the latest build information for GitHub Pages of a specified repository. It should be called when the user wants to know the most recent build status or details for a GitHub Pages site.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Enter the name without considering case sensitivity.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-latest-pages-build'.
#

GithubApi.GetLatestGithubRelease

Retrieve the latest full release from a GitHub repository. This tool fetches the most recent full release from a specified GitHub repository, excluding prerelease and draft releases. It is useful for monitoring updates and obtaining the latest stable release information.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository to retrieve the latest release from. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-latest-release'.
#

GithubApi.GetLicenseInformation

Retrieve GitHub Enterprise license information. Use this tool to fetch information about your GitHub Enterprise license settings. It is helpful for administrators who need to manage license details.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-license-information'.
#

GithubApi.GetMilestoneStatistics

Retrieve GitHub enterprise milestone statistics. Use this tool to get statistics about milestones in a GitHub enterprise environment. It is useful for understanding project progress and tracking milestones.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-milestone-stats'.
#

GithubApi.GetOctocatAsciiArt

Retrieve the octocat as ASCII art. Use this tool to get the octocat character depicted in ASCII art from GitHub.

Parameters

ParameterTypeReq.Description
speech_bubble_textstringOptionalText to display in Octocat's speech bubble. Provide a string with the desired message.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'meta/get-octocat'.
#

GithubApi.GetOidcCustomSubTemplateForOrg

Retrieves the OIDC subject claim customization template for an organization. Use this tool to get the customization template for an OpenID Connect (OIDC) subject claim for a specific organization. This requires authentication with a GitHub access token with `read:org` scope or a GitHub App with `organization_administration:write` permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization for which you want to retrieve the OIDC customization template. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'oidc/get-oidc-custom-sub-template-for-org'.
#

GithubApi.GetOidcSubjectClaimTemplate

Retrieve the OIDC subject claim customization template for a repository. Use this tool to get the customization template for an OpenID Connect (OIDC) subject claim for a specific GitHub repository. Requires authentication with a token having `repo` scope, or `organization_administration:read` permission for GitHub Apps.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-custom-oidc-sub-claim-for-repo'.
#

GithubApi.GetOrganizationPublicKey

Retrieve the public key for GitHub organization secrets encryption. Use this tool to obtain the public key necessary for encrypting secrets before creation or update within a GitHub organization. This requires authentication with an access token that has the `admin:org` scope. Suitable for use when managing organization secrets securely.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name. This is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-org-public-key'.
#

GithubApi.GetOrganizationVariable

Retrieve a specific variable from a GitHub organization. Use this tool to access a particular variable within a GitHub organization. Requires authentication with an access token with the 'admin:org' scope or a GitHub App with 'organization_actions_variables:read' permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name. This value is not case sensitive.
variable_namestringRequiredThe exact name of the specific variable to retrieve from the organization.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-org-variable'.
#

GithubApi.GetOrgAnnouncementBanner

Retrieve the announcement banner for a specific organization. Fetches the current announcement banner set at the organization level. Does not include enterprise-level banners.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'announcement-banners/get-announcement-banner-for-org'.
#

GithubApi.GetOrgAuditLog

Retrieve the audit log for a GitHub organization. This tool retrieves the audit log for a specified GitHub organization. It is used to monitor and review up to 30 events from the past three months by default. Organization owners or GitHub Apps with appropriate permissions can filter, paginate, and analyze audit events using this tool. Useful for tracking organization activities and security events.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
event_orderstringOptionalSpecify the order of audit log events. Use 'desc' for newest first or 'asc' for oldest first. Default is 'desc'.
event_types_to_includestringOptionalSpecify the event types to include: 'web' for web events, 'git' for Git events, or 'all' for both. Default is 'web'.
results_page_numberintegerOptionalSpecify the page number of results to fetch. Useful for navigating through paginated audit log entries.
results_per_pageintegerOptionalDefines the number of audit log events returned per page, with a maximum of 100.
search_events_after_cursorstringOptionalCursor for searching events after a specific point, as given in the Link header.
search_events_before_cursorstringOptionalA cursor to search for events before this point. Use to limit results to events occurring before a specific reference.
search_phrasestringOptionalA string to filter audit log events based on specific criteria. This can help in retrieving older events. Refer to the GitHub documentation for more details on searching the audit log.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/get-audit-log'.
#

GithubApi.GetOrgMembershipStatus

Retrieve the user's organization membership status. Use this tool to get the membership details of an authenticated user within a specified organization on GitHub. It is useful for checking the user's roles and permissions in the organization.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. It is not case sensitive and should be provided as a string.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/get-membership-for-authenticated-user'.
#

GithubApi.GetOrgPreReceiveHook

Retrieve a pre-receive hook for an organization. Fetches details of a specific pre-receive hook associated with a GitHub organization using the organization's name and the hook ID.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization; case insensitive.
pre_receive_hook_unique_idintegerRequiredThe unique identifier of the pre-receive hook. Must be an integer.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-pre-receive-hook-for-org'.
#

GithubApi.GetOrgPublicKey

Retrieve the public key for encrypting GitHub Dependabot secrets. Use this tool to get your GitHub organization's public key, which is necessary for encrypting secrets before creating or updating them in Dependabot. Ensure authentication with an access token with the `admin:org` scope or GitHub App permissions for `dependabot_secrets`.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name, not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/get-org-public-key'.
#

GithubApi.GetOrgRunnerRemovalToken

Get a token to remove a self-hosted runner from an organization. Use this tool to obtain a token for removing a self-hosted runner from a GitHub organization. The token expires after one hour and requires an access token with the `admin:org` scope for authentication.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/create-remove-token-for-org'.
#

GithubApi.GetOrgSecretInfo

Retrieve details of an organization's secret without revealing the encrypted value. This tool fetches a single organization secret's details from GitHub without disclosing the encrypted value. Use it when you need information about a secret within an organization. Authentication with an access token with `admin:org` scope is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
organization_secret_namestringRequiredThe name of the secret for the organization. It is required to identify the specific secret without revealing its encrypted value. This name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/get-org-secret'.
#

GithubApi.GetOrgSelfHostedRunner

Get details of a self-hosted runner for an organization. Fetches information about a specific self-hosted runner configured in a GitHub organization. Authentication with an access token having the `admin:org` scope is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name (not case sensitive).
runner_idintegerRequiredUnique integer identifier of the self-hosted runner within the organization.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-self-hosted-runner-for-org'.
#

GithubApi.GetOrgWebhookConfiguration

Retrieve webhook configuration for a GitHub organization. Call this tool to get the webhook configuration for a specified organization on GitHub. Useful for checking the webhook's setup details. Requires appropriate access tokens or GitHub App permissions.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe non-case-sensitive name of the GitHub organization.
webhook_hook_idintegerRequiredThe unique identifier of the organization's webhook, provided as an integer.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/get-webhook-config-for-org'.
#

GithubApi.GetOrgWebhookDetails

Retrieve details of a specific organization webhook. Use this tool to obtain detailed information about a webhook configured in a GitHub organization, including its properties and settings.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization, not case sensitive.
webhook_idintegerRequiredThe unique identifier for the organization's webhook. This is an integer value used to specify which webhook details to retrieve.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/get-webhook'.
#

GithubApi.GetPendingDeploymentsForRun

Retrieve pending deployments for a GitHub workflow run. Use this tool to obtain all deployment environments for a specific GitHub workflow run that are awaiting protection rules to pass. Accessible to users with read access to the repository; requires `repo` scope for private repos or `actions:read` permission for GitHub Apps.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
workflow_run_idintegerRequiredThe unique identifier of the workflow run to fetch pending deployments for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-pending-deployments-for-run'.
#

GithubApi.GetPreReceiveEnvDownloadStatus

Retrieve the latest download status for a pre-receive environment. Use this tool to check the most recent download status for a pre-receive environment within GitHub Enterprise Administration. It's useful for monitoring or verifying the status separately from other environment data.

Parameters

ParameterTypeReq.Description
pre_receive_environment_identifierintegerRequiredThe unique identifier for the pre-receive environment to retrieve its download status.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-download-status-for-pre-receive-environment'.
#

GithubApi.GetPreReceiveHook

Retrieve details of a specific pre-receive hook in GitHub Enterprise Admin. This tool is used to get information about a specific pre-receive hook by its ID in GitHub Enterprise. It is helpful for administrators managing repositories who need to view hook configurations.

Parameters

ParameterTypeReq.Description
pre_receive_hook_idintegerRequiredThe unique identifier of the pre-receive hook to retrieve details for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-pre-receive-hook'.
#

GithubApi.GetPreReceiveHookForRepo

Retrieve a pre-receive hook for a specific repository. Use this tool to obtain the details of a specific pre-receive hook associated with a GitHub repository. Ideal for administrators managing repository hooks.

Parameters

ParameterTypeReq.Description
pre_receive_hook_idintegerRequiredThe unique identifier of the pre-receive hook for the repository.
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-pre-receive-hook-for-repo'.
#

GithubApi.GetProjectCard

Retrieve details of a specific project card in GitHub. Use this tool to get information about a project card in a GitHub project by specifying the card ID. Useful for retrieving details such as card content, column association, and other metadata.

Parameters

ParameterTypeReq.Description
project_card_idintegerRequiredThe unique ID of the GitHub project card to retrieve details for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/get-card'.
#

GithubApi.GetPublicSshKeyDetails

Retrieve details for a specified public SSH key. This tool fetches extended details for a single public SSH key of the authenticated user. It requires authentication via Basic Auth or OAuth with 'read:public_key' scope.

Parameters

ParameterTypeReq.Description
ssh_key_identifierintegerRequiredThe unique identifier for the public SSH key to retrieve details.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/get-public-ssh-key-for-authenticated-user'.
#

GithubApi.GetPublicSshKeys

Retrieve verified public SSH keys for a specified GitHub user. Use this tool to access the verified public SSH keys associated with a GitHub user's account. This information is publicly accessible and can help in identifying trusted keys for secure connections.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user's handle to retrieve their verified public SSH keys.
results_page_numberintegerOptionalSpecify the page number of results to retrieve for pagination purposes.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum allowed value of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/list-public-keys-for-user'.
#

GithubApi.GetPullRequestDetails

Retrieve details of a specific GitHub pull request. Use this tool to obtain comprehensive information about a specified pull request in a GitHub repository, including its mergeability status and commit details.

Parameters

ParameterTypeReq.Description
pull_request_numberintegerRequiredThe unique number identifying the pull request to retrieve details for.
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredSpecifies the account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/get'.
#

GithubApi.GetPullRequestReviewProtection

Get pull request review protection details for a branch. Fetches details about the required pull request review protection for a specific branch in a GitHub repository. Useful for understanding branch protection rules in repositories.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe name of the branch. Cannot contain wildcard characters. For wildcard usage, refer to the GraphQL API.
repository_namestringRequiredThe name of the repository to retrieve pull request review protection details for. This name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. It is not case sensitive and identifies who owns the repository.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-pull-request-review-protection'.
#

GithubApi.GetPullRequestStatistics

Retrieve pull request statistics from GitHub Enterprise. Use this tool to obtain statistics related to pull requests from a GitHub Enterprise instance.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-pull-request-stats'.
#

GithubApi.GetRandomGithubZen

Fetch a random Zen of GitHub sentence. Retrieves a random inspirational sentence from GitHub's Zen collection, useful for inspiration or fun.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'meta/get-zen'.
#

GithubApi.GetRemoveTokenForEnterpriseRunner

Generates a token to remove a self-hosted runner from an enterprise. Use this tool to obtain a token for removing a self-hosted runner from an enterprise on GitHub. The token is valid for one hour and requires authentication with an access token having the 'manage_runners:enterprise' scope.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID of the enterprise. Use this to specify the enterprise for which you want to generate a removal token.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/create-remove-token-for-enterprise'.
#

GithubApi.GetRepoCodeFrequency

Get weekly code frequency stats for a GitHub repository. Fetches a weekly summary of code additions and deletions for a specified GitHub repository, providing insights into development activity.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The GitHub username is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-code-frequency-stats'.
#

GithubApi.GetRepoCommitParticipation

Retrieve weekly commit participation stats for a GitHub repo. This tool fetches the total commit counts for a repository's owner and overall contributors over the last 52 weeks. It helps in understanding the contribution patterns and can determine non-owner contributions by subtracting owner counts from total counts.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository, which is not case sensitive.
repository_ownerstringRequiredThe repository account owner on GitHub. Case-insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-participation-stats'.
#

GithubApi.GetRepoLicense

Fetch the license file of a GitHub repository. This tool retrieves the contents of a repository's license file from GitHub if one is detected. It can handle both raw license content and rendered HTML. Use this tool to understand the licensing terms associated with any given repository.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'licenses/get-for-repo'.
#

GithubApi.GetRepoNotifications

Retrieve notifications for the user in a specific repository. This tool lists all notifications for the authenticated user in a specified GitHub repository. Use it to keep track of issues, pull requests, and other updates relevant to the user.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository, not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
include_read_notificationsbooleanOptionalIf `true`, include notifications that have been marked as read.
results_page_numberintegerOptionalSpecify the page number of the results to fetch. Useful for paginating through notifications.
results_per_pageintegerOptionalNumber of notifications to display per page, with a maximum of 100.
show_only_participation_notificationsbooleanOptionalIf `true`, only show notifications where the user is directly participating or mentioned.
updated_after_timestampstringOptionalShow notifications updated after this timestamp. Use ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.
updated_beforestringOptionalDisplay notifications updated before this time in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/list-repo-notifications-for-authenticated-user'.
#

GithubApi.GetRepoPublicKey

Retrieve the public key for encrypting repository secrets. Use this tool to get the public key necessary for encrypting secrets in a GitHub repository. This is a prerequisite step before creating or updating secrets. Ensure you have the necessary access rights: read access for public repositories, or an access token with the `repo` scope for private ones. GitHub Apps require `secrets` permission.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This value is not case sensitive. Provide the repository name for which you want to retrieve the public key.
repository_ownerstringRequiredThe account owner of the repository. Enter a case-insensitive string specifying the owner's account name.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-repo-public-key'.
#

GithubApi.GetRepoSecretInfo

Retrieve metadata of a repository secret from GitHub. Fetches information about a specific repository secret using GitHub's Dependabot API. It provides metadata without revealing the secret's encrypted value. Requires an authenticated access token with proper permissions.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository, case insensitive.
secret_namestringRequiredThe name of the secret to retrieve metadata for. Case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/get-repo-secret'.
#

GithubApi.GetRepositoryReadme

Retrieve the preferred README for a GitHub repository. Use this tool to fetch the preferred README of a GitHub repository. It can retrieve the raw content or rendered HTML based on custom media types.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This is case insensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
commit_branch_tag_namestringOptionalSpecify the commit, branch, or tag name. Defaults to the repository's default branch if not provided.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-readme'.
#

GithubApi.GetRepositorySecretInfo

Retrieve metadata for a specific GitHub repository secret. This tool retrieves the metadata of a specified secret from a GitHub repository without exposing its encrypted value. It requires authentication with an access token that has the `repo` scope, or GitHub Apps with `secrets` repository permissions.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Not case sensitive.
secret_namestringRequiredThe name of the secret to retrieve metadata for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-repo-secret'.
#

GithubApi.GetRepositoryStatistics

Retrieve statistics for GitHub repositories. This tool is used to get statistical information about repositories in a GitHub enterprise setting. It should be called when detailed repository stats are needed.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-repo-stats'.
#

GithubApi.GetRepositoryTagProtectionStates

Fetch the tag protection states of a GitHub repository. Call this tool to retrieve the tag protection settings for a specific GitHub repository. This information is available only to repository administrators, providing insights into how tags are protected within the repository.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. The name is not case sensitive.
repository_ownerstringRequiredThe GitHub username of the account owner for the repository. This value is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-tag-protection'.
#

GithubApi.GetRepoSubscription

Retrieve subscription status for a GitHub repository. Use this tool to check if you are subscribed to a specific GitHub repository and receive notifications about its activity. It provides the subscription status and additional details.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. The name is not case sensitive.
repository_ownerstringRequiredThe GitHub username of the repository owner. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/get-repo-subscription'.
#

GithubApi.GetRepoTopics

Retrieve all topics for a specific GitHub repository. Call this tool to get a list of topics associated with a specific repository on GitHub. It can help understand the themes or categories the repository covers.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is not case sensitive.
page_numberintegerOptionalThe page number of results to fetch. Useful for paginating through large data sets.
results_per_pageintegerOptionalThe number of results to fetch per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-all-topics'.
#

GithubApi.GetRepoWebhook

Retrieve the webhook configuration for a specific repository. This tool is used to get the details of a webhook configured in a specific GitHub repository. It can be called when you need information about a webhook associated with a given repository, such as its settings and properties.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This value is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
webhook_idintegerRequiredThe unique identifier of the webhook to be retrieved.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-webhook'.
#

GithubApi.GetRepoWebhookConfig

Get the webhook configuration for a GitHub repository. Use this tool to retrieve the webhook configuration settings for a specific GitHub repository. It requires a valid access token with `read:repo_hook` or `repo` scope, or a GitHub App with `repository_hooks:read` permission.

Parameters

ParameterTypeReq.Description
hook_identifierintegerRequiredThe unique identifier for the webhook. This is required to retrieve the specific webhook configuration for a repository.
repository_namestringRequiredThe name of the GitHub repository. Not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Provide a non-case sensitive username.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-webhook-config-for-repo'.
#

GithubApi.GetRequestedReviewersForPr

Retrieve users or teams requested for a pull request review. Use this tool to get the list of users or teams who have been requested to review a specific pull request in a GitHub repository. This is useful for checking pending review tasks.

Parameters

ParameterTypeReq.Description
pull_request_numberintegerRequiredThe unique identifier for the pull request in a GitHub repository.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/list-requested-reviewers'.
#

GithubApi.GetRequiredWorkflow

Retrieve a required workflow for a GitHub organization. This tool retrieves information about a required workflow configured in a GitHub organization. It requires authentication with a token having the `read:org` scope.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name. This name is not case sensitive.
workflow_idintegerRequiredThe unique identifier of the workflow to retrieve for the organization.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-required-workflow'.
#

GithubApi.GetReviewComments

Retrieve comments for a specific pull request review. Use this tool to obtain comments associated with a specific pull request review in a GitHub repository. Ideal for tracking review discussions and understanding feedback provided by reviewers.

Parameters

ParameterTypeReq.Description
pull_request_numberintegerRequiredThe number that identifies the pull request to fetch comments from.
repository_namestringRequiredThe name of the GitHub repository. This name is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. It is not case sensitive.
review_idintegerRequiredThe unique identifier of the review for which comments are being fetched.
result_page_numberintegerOptionalSpecify the page number of the results to fetch. Used to navigate paginated results.
results_per_pageintegerOptionalSpecify the number of results per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/list-comments-for-review'.
#

GithubApi.GetSarifAnalysisInfo

Retrieve SARIF upload status and analysis URL. Use this tool to get information about a SARIF upload, including its status and the URL for detailed analysis. Useful for tracking code scanning results in GitHub repositories. Requires appropriate access tokens or permissions.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This input is case-insensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. This input is not case sensitive.
sarif_idstringRequiredThe SARIF ID obtained after uploading. It is used to retrieve analysis details.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'code-scanning/get-sarif'.
#

GithubApi.GetScimGroupInfo

Retrieve provisioning information for a SCIM group in an enterprise. Use this tool to get detailed provisioning information of a specific SCIM group within an enterprise account. This can be essential for managing and auditing group memberships and access within an organization.

Parameters

ParameterTypeReq.Description
scim_group_identifierstringRequiredA unique identifier for the SCIM group to retrieve its provisioning information.
exclude_attributesstringOptionalSpecify attributes to exclude from the response to speed up retrieval.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-provisioning-information-for-enterprise-group'.
#

GithubApi.GetScimUserInfo

Fetch SCIM user provisioning information. Retrieves information about a SCIM user in an enterprise account. Suitable for obtaining detailed provisioning data of a user within the GitHub enterprise environment.

Parameters

ParameterTypeReq.Description
scim_user_identifierstringRequiredThe unique identifier for the SCIM user in the GitHub enterprise environment.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-provisioning-information-for-enterprise-user'.
#

GithubApi.GetSecurityAnalysisSettings

Get security analysis settings for an enterprise. Retrieve code security and analysis settings for a specified enterprise. Requires admin access to the enterprise and an access token with the `admin:enterprise` scope.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug version or ID of the enterprise. Use the enterprise's slug name or its ID to specify it.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'secret-scanning/get-security-analysis-settings-for-enterprise'.
#

GithubApi.GetSelfHostedRunnerGroup

Retrieve a specific self-hosted runner group for an enterprise. Use this tool to get details of a particular self-hosted runner group within an enterprise. Authentication with an access token is required, including the `manage_runners:enterprise` scope.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug of the enterprise name or substitute with the enterprise ID.
runner_group_identifierintegerRequiredUnique identifier of the self-hosted runner group, required to retrieve specific group details within an enterprise.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-self-hosted-runner-group-for-enterprise'.
#

GithubApi.GetSelfHostedRunnerGroupForOrg

Retrieve a specific self-hosted runner group for an organization. Use this tool to obtain details about a particular self-hosted runner group within an organization on GitHub. Requires authentication with an access token having 'admin:org' scope.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe organization name on GitHub. It is not case sensitive.
runner_group_identifierintegerRequiredUnique identifier for the self-hosted runner group. It should be an integer.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-self-hosted-runner-group-for-org'.
#

GithubApi.GetSelfHostedRunnerInfo

Retrieve details of a self-hosted runner in an enterprise. Fetches information about a specific self-hosted runner configured within an enterprise on GitHub. Requires authentication with an access token having `manage_runners:enterprise` scope.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug version of the enterprise name or the enterprise ID.
runner_idintegerRequiredThe unique identifier of the self-hosted runner to retrieve details for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/get-self-hosted-runner-for-enterprise'.
#

GithubApi.GetSshSigningKeyDetails

Retrieve extended details for an SSH signing key. Use this tool to get detailed information of an SSH signing key for an authenticated GitHub user. Requires authentication with either Basic Authentication or OAuth with `read:ssh_signing_key` scope.

Parameters

ParameterTypeReq.Description
ssh_signing_key_identifierintegerRequiredThe unique identifier of the SSH signing key to retrieve details for the authenticated user.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/get-ssh-signing-key-for-authenticated-user'.
#

GithubApi.GetTeamBySlug

Retrieve team details using organization and team slug. Use this tool to get detailed information about a specific team in a GitHub organization by providing the organization's name and the team's slug. The slug is a modified version of the team's name, formatted by GitHub.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
team_slugstringRequiredThe slug of the team name. This is a URL-friendly version, typically all lowercase with special characters and spaces replaced by hyphens.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/get-by-name'.
#

GithubApi.GetTeamDiscussion

Retrieve a specific team discussion from GitHub. Call this tool to get details of a specific discussion on a GitHub team's page. This is useful when you need information about a particular topic discussed within a team. Ensure OAuth access tokens with `read:discussion` scope are used.

Parameters

ParameterTypeReq.Description
discussion_identifier_numberintegerRequiredThe unique number identifying the discussion to retrieve.
organization_namestringRequiredThe name of the GitHub organization. This is not case sensitive.
team_slugstringRequiredThe slug of the GitHub team name, used to specify the team.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/get-discussion-in-org'.
#

GithubApi.GetTeamDiscussionReactions

Retrieve reactions to a specific team discussion in a GitHub organization. Use this tool to obtain the reactions to a team discussion within a GitHub organization. It requires an OAuth token with the `read:discussion` scope. Useful for analyzing feedback or participation in team discussions.

Parameters

ParameterTypeReq.Description
discussion_identifierintegerRequiredThe number identifying the team discussion to retrieve reactions for.
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
team_slugstringRequiredThe slug of the team's name in the specified GitHub organization. It identifies the team for which reactions are being retrieved.
reaction_typestringOptionalSpecify the type of reaction to retrieve (e.g., '+1', '-1', 'laugh'). Omit to retrieve all reactions.
results_page_numberintegerOptionalThe page number of the results to fetch. Use to navigate through paginated responses.
results_per_pageintegerOptionalSpecify the number of results per page, maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/list-for-team-discussion-in-org'.
#

GithubApi.GetTeamsWithPushAccessToBranch

Retrieve teams with push access to a protected branch. Call this tool to get a list of teams that have push access to a specified protected branch in a GitHub repository. Useful for managing and reviewing team permissions.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe name of the branch to retrieve teams with push access. Wildcard characters are not allowed.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe GitHub username or organization name that owns the repository. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-teams-with-access-to-protected-branch'.
#

GithubApi.GetUserGists

Retrieve a user's public gists from GitHub. This tool is used to list all public gists for a specified GitHub user. It should be called when you want to retrieve code snippets or files shared publicly by the user.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub username whose public gists you want to retrieve.
page_numberintegerOptionalPage number of the gist results to fetch. Used for paginating results.
results_per_pageintegerOptionalThe number of gists to display per page, with a maximum limit of 100.
updated_after_timestampstringOptionalShow notifications updated after the specified timestamp in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/list-for-user'.
#

GithubApi.GetUserGpgKeyDetails

Retrieve extended details for a user's GPG key. Use this tool to fetch detailed information about a specific GPG key for an authenticated user. Requires authentication via Basic Auth or OAuth with 'read:gpg_key' scope.

Parameters

ParameterTypeReq.Description
gpg_key_identifierintegerRequiredThe unique identifier of the GPG key to retrieve details for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/get-gpg-key-for-authenticated-user'.
#

GithubApi.GetUserOrgEvents

Retrieve organization events for an authenticated GitHub user. Use this tool to get the events related to a user's organization activities on GitHub. It requires authentication as the user to access the details of the organization dashboard.

Parameters

ParameterTypeReq.Description
github_usernamestringRequiredThe GitHub handle of the user account for whom events are being retrieved. Authentication is required to access user-specific details.
organization_namestringRequiredThe name of the GitHub organization. This parameter is not case sensitive.
results_page_numberintegerOptionalThe specific page of results to retrieve. Provides pagination for fetching events.
results_per_pageintegerOptionalSpecify the number of results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/list-org-events-for-authenticated-user'.
#

GithubApi.GetUserOrgMembershipStatus

Get a user's membership status in an organization. Call this tool to retrieve the membership status of a user within a specified GitHub organization. Requires the authenticated user to be an organization member.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe handle for the GitHub user account to check membership status.
organization_namestringRequiredThe GitHub organization name. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/get-membership-for-user'.
#

GithubApi.GetUserProjectPermission

Retrieve a user's permission level for an organization project. Use this tool to find out what level of access a specific user has to an organization project on GitHub. This is useful for organization owners or project admins to verify permissions.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub username of the user whose project permission level is being queried.
project_idintegerRequiredThe unique identifier of the GitHub project for which to fetch the user's permission.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/get-permission-for-user'.
#

GithubApi.GetUserReceivedGithubEvents

Retrieve events received by a GitHub user. Fetches events that a specified user has received on GitHub by watching repositories and following users. Access includes private events if authenticated as the user, or public events otherwise.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe handle of the GitHub user account for which to retrieve events.
result_page_numberintegerOptionalSpecifies the page number of results to retrieve from the GitHub events list.
results_per_pageintegerOptionalSpecify the number of results per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/list-received-events-for-user'.
#

GithubApi.GetUserRepos

Retrieve public repositories of a GitHub user. This tool retrieves a list of public repositories for a specified GitHub user. It can also list internal repositories for GitHub AE. Use this tool to explore the projects a user has made publicly available on GitHub.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe handle for the GitHub user whose repositories you want to retrieve.
page_numberintegerOptionalThe page number of results to fetch, starting from 1.
repository_typestringOptionalLimit results to repositories of the specified type: 'all', 'owner', or 'member'.
results_per_pageintegerOptionalSpecify the number of repository results to be returned per page, up to a maximum of 100.
sort_orderstringOptionalSpecifies the order to sort the repositories. Use 'asc' for ascending and 'desc' for descending order.
sort_results_bystringOptionalSpecify the property to sort the repository results by. Options: 'created', 'updated', 'pushed', or 'full_name'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-for-user'.
#

GithubApi.GetUserTeamMembershipInOrg

Retrieve a user's team membership status in an organization. Fetches the membership state and role of a specified user within a specific team in an organization on GitHub. Useful for determining if a user is a member of a team, including the role they hold.

Parameters

ParameterTypeReq.Description
github_usernamestringRequiredThe GitHub username of the account whose team membership status is being retrieved. This username is not case sensitive.
organization_namestringRequiredThe case-insensitive name of the GitHub organization.
team_slugstringRequiredThe slug of the team name. It uniquely identifies the team within the organization. Case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/get-membership-for-user-in-org'.
#

GithubApi.GetWebhookDelivery

Retrieve a specific webhook delivery from a repository. This tool retrieves details of a webhook delivery for a specified repository. Use it when you need to examine the delivery status or contents of a webhook event.

Parameters

ParameterTypeReq.Description
hook_identifierintegerRequiredThe unique identifier of the webhook within a repository. It is an integer value required to specify which webhook's delivery information to retrieve.
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository, not case sensitive.
webhook_delivery_idintegerRequiredThe unique identifier of the specific webhook delivery to retrieve details for. This is an integer value.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-webhook-delivery'.
#

GithubApi.GetWebhookEventDeliveries

Retrieve webhook deliveries for an organization. Call this tool to get a list of webhook deliveries for a specific webhook configured in a GitHub organization. It is useful for monitoring and debugging webhook events.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
webhook_hook_idintegerRequiredThe unique identifier of the webhook in the organization.
include_redeliveriesbooleanOptionalIndicate whether to include repeated webhook deliveries in the results. Set to true to include.
pagination_start_cursorstringOptionalA cursor to indicate the starting delivery for fetching the page of deliveries. Useful for pagination purposes.
results_per_pageintegerOptionalSpecifies the number of webhook deliveries to be returned per page (maximum 100).

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/list-webhook-deliveries'.
#

GithubApi.GetWorkflowAccessLevel

Determine external workflow access level for a repository. Utilize this tool to find out what level of access workflows outside of a specified internal or private repository have to its actions and reusable workflows. This tool is applicable only to internal and private repositories and requires appropriate authentication.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository (case insensitive).
repository_ownerstringRequiredThe account owner of the repository. This is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-workflow-access-to-repository'.
#

GithubApi.GetWorkflowArtifact

Retrieve a specific artifact from a GitHub workflow run. Use this tool to access a specific artifact from a GitHub repository's workflow run. Requires appropriate permissions and access token for private repositories.

Parameters

ParameterTypeReq.Description
artifact_identifierintegerRequiredThe unique identifier for the artifact to retrieve from a workflow run.
repository_namestringRequiredThe name of the repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-artifact'.
#

GithubApi.GetWorkflowRunAttemptLogsUrl

Retrieve a URL to download workflow run attempt logs. Returns a redirect URL to download log files for a specific workflow run attempt. This URL expires in 1 minute and requires appropriate repository access permissions.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. It is not case sensitive and identifies the repository for which to retrieve logs.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
workflow_attempt_numberintegerRequiredThe specific attempt number of the workflow run to fetch logs for.
workflow_run_idintegerRequiredThe unique identifier of the workflow run. Used to specify which workflow's logs to download.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/download-workflow-run-attempt-logs'.
#

GithubApi.GithubCreateIssueComment

Create a comment on a GitHub issue. Use this tool to add a comment to a specific issue in a GitHub repository. Ensure you manage content creation speed to avoid secondary rate limiting.

Parameters

ParameterTypeReq.Description
comment_contentstringRequiredThe text content of the comment to be added to the issue.
issue_identifierintegerRequiredThe unique number identifying the GitHub issue.
repository_namestringRequiredThe name of the repository where the issue is located. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/create-comment'.
#

GithubApi.GithubManageEnvironment

Create or update a GitHub environment with protection rules. Use this tool to create or update a GitHub environment, applying protection rules like required reviewers. Ensure you authenticate with an access token with the `repo` scope. GitHub Apps need `administration:write` permission for the repository. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the GitHub repository. This value is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
environment_namestringOptionalThe name of the GitHub environment to create or update. This should be a string that accurately identifies the environment within the repository. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-or-update-environment'.
#

GithubApi.GithubRerunWorkflowJob

Re-run a job in a GitHub workflow. This tool re-runs a specific job and its dependent jobs within a GitHub workflow run. Use it when you need to restart a job that has failed or requires re-execution. Requires authentication with an access token having `repo` scope or `actions:write` permission for GitHub Apps.

Parameters

ParameterTypeReq.Description
job_identifierintegerRequiredThe unique integer identifier of the job to be re-run. This is required to specify which job in the workflow needs to be restarted.
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
enable_debug_loggingbooleanOptionalSet to true to enable debug logging for the re-run.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/re-run-job-for-workflow-run'.
#

GithubApi.GithubSearchUsers

Search for GitHub users based on specific criteria. This tool allows you to find GitHub users by using various search parameters like login, email, name, repositories, and followers count. It can return up to 100 users per page and includes options for retrieving text match metadata for highlighted results.

Parameters

ParameterTypeReq.Description
search_querystringRequiredContains search keywords and qualifiers to find GitHub users. Supports multiple qualifiers to narrow the search. See GitHub's query format documentation for details.
page_numberintegerOptionalPage number to fetch results, used for accessing subsequent pages of search results. Maximum supported is 100.
results_per_pageintegerOptionalThe number of GitHub user results returned per page, up to a maximum of 100.
sort_by_criterionstringOptionalSort the search results by 'followers', 'repositories', or 'joined'. Defaults to best match if not specified.
sort_orderstringOptionalSpecifies the order of search results: 'desc' for highest matches or 'asc' for lowest. Requires 'sort'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'search/users'.
#

GithubApi.GrantPushAccessGithubBranch

Grant push access to specified users for a GitHub branch. This tool is used to grant push access to specific users for a protected branch in a GitHub repository. It is applicable in scenarios involving public repositories with GitHub Free and GitHub Free for organizations, as well as public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository. It is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
branch_namestringOptionalThe name of the branch to grant push access. Cannot contain wildcard characters. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/add-user-access-restrictions'.
#

GithubApi.InitiateUserMigration

Begin the creation of a user migration archive. This tool is used to initiate the generation of a migration archive for an authenticated GitHub user. Call this when you want to start the process of exporting your data for transfer or backup purposes.

Parameters

ParameterTypeReq.Description
repository_listarray<string>RequiredA list of repository names to be included in the migration. Expect an array of strings representing repository names.
exclude_attachmentsbooleanOptionalSet to true to exclude attachments from the migration.
exclude_attributesarray<string>OptionalList of attributes to exclude from the API response for better performance.
exclude_metadatabooleanOptionalSet to true to exclude metadata and include only git source in the migration.
exclude_owner_projectsbooleanOptionalSet to true to exclude projects owned by the organization or users from the migration process.
exclude_releasesbooleanOptionalSet to true to exclude releases from the migration process.
exclude_repository_git_databooleanOptionalSet to true to exclude repository git data from the migration.
lock_repositoriesbooleanOptionalSet to true to lock the repositories at the start of the migration.
org_metadata_onlybooleanOptionalSet to true to include only organization metadata. Repositories array will be empty and other flags are ignored.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'migrations/start-for-authenticated-user'.
#

GithubApi.LabelRunnerForRepo

Add custom labels to a repository's self-hosted runner. Use this tool to add custom labels to a self-hosted runner in a specified GitHub repository. Authentication with an access token with the `repo` scope is required.

Parameters

ParameterTypeReq.Description
custom_labels_to_addarray<string>RequiredThe names of the custom labels to add to the self-hosted runner. Provide as an array of strings.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Case insensitive.
runner_idintegerRequiredUnique identifier for the self-hosted runner in the repository.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/add-custom-labels-to-self-hosted-runner-for-repo'.
#

GithubApi.LinkExternalGroupToTeam

Link an external IDP group to a GitHub team. Creates a connection between a GitHub team and an external identity provider group. Use this tool when you need to manage team membership through your identity provider using GitHub Enterprise Managed Users.

Parameters

ParameterTypeReq.Description
external_group_idintegerRequiredThe ID of the external group to be linked with the GitHub team.
organization_namestringRequiredThe GitHub organization name. This value is not case sensitive.
team_slugstringRequiredThe slug of the team name to connect with an external group. It is case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/link-external-idp-group-to-team-for-org'.
#

GithubApi.ListActionsEnabledOrgsEnterprise

List organizations with GitHub Actions enabled in an enterprise. This tool lists organizations selected to have GitHub Actions enabled within a specified enterprise. It requires the enterprise permission policy for `enabled_organizations` to be set to `selected`. Authentication with an access token with the `admin:enterprise` scope is necessary.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID of the enterprise to identify it for listing organizations with GitHub Actions enabled.
results_page_numberintegerOptionalSpecifies which page of results to retrieve, helpful for navigating through multiple pages.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/list-selected-organizations-enabled-github-actions-enterprise'.
#

GithubApi.ListActionsEnabledRepos

Retrieve repositories enabled for GitHub Actions in an organization. Use this tool to list all repositories where GitHub Actions are enabled within a specific organization. Ensure the organization permission policy for `enabled_repositories` is set to `selected`. Authentication with a token having `admin:org` scope or a GitHub App with `administration` permission is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization for which to list GitHub Actions-enabled repositories. This field is not case sensitive.
result_page_numberintegerOptionalPage number of the results to fetch. Use for paginating through results.
results_per_pageintegerOptionalThe maximum number of repositories to return per page (max 100).

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-selected-repositories-enabled-github-actions-organization'.
#

GithubApi.ListBranchesForCommit

Retrieve branches for a specific commit in a GitHub repository. Call this tool to find all branches where the given commit SHA is the HEAD or the latest commit for the branch in a GitHub repository. Useful for tracking branch status in different GitHub plans.

Parameters

ParameterTypeReq.Description
commit_shastringRequiredThe SHA hash of the commit used to identify specific branches where this commit is the HEAD in a GitHub repository.
repository_namestringRequiredThe name of the GitHub repository. Not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository, not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-branches-for-head-commit'.
#

GithubApi.ListCheckRunAnnotations

Retrieve annotations for a GitHub check run. Use this tool to fetch a list of annotations associated with a specific check run in a GitHub repository. Requires appropriate permissions on private repositories.

Parameters

ParameterTypeReq.Description
check_run_identifierintegerRequiredThe ID of the check run to retrieve annotations for.
repository_namestringRequiredThe name of the GitHub repository (case insensitive).
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
results_page_numberintegerOptionalSpecify the page number to fetch annotations from. Used for paginating results.
results_per_pageintegerOptionalThe number of results per page to return, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'checks/list-annotations'.
#

GithubApi.ListCheckRunsForCommitRef

Lists check runs for a given commit reference. Fetches check runs associated with a specific commit reference (SHA, branch, or tag) in a repository. Requires appropriate permissions: 'checks:read' for private repositories and 'repo' scope for OAuth Apps on private repositories.

Parameters

ParameterTypeReq.Description
commit_referencestringRequiredThe commit reference, which can be a SHA, branch name, or tag name, to list check runs for.
repository_namestringRequiredThe name of the repository. Input is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is not case sensitive and refers to the GitHub username or organization name.
application_idintegerOptionalOptional integer identifier for a GitHub App to filter check runs created by that app.
check_run_namestringOptionalSpecify a name to filter check runs by their name.
check_run_statusstringOptionalFilter check runs by specifying the status ('queued', 'in_progress', 'completed').
filter_by_completion_timestampstringOptionalSpecify 'latest' to return the most recent check runs or 'all' to include all completed check runs.
results_page_numberintegerOptionalThe specific page number of results to retrieve, used for pagination.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'checks/list-for-ref'.
#

GithubApi.ListCheckSuitesForRef

List check suites for a specific commit reference. Retrieve a list of check suites for a given commit reference (SHA, branch, or tag name). Ensure the appropriate permissions are in place for accessing private or public repositories. This tool is useful for checking the status of checks related to a specific commit.

Parameters

ParameterTypeReq.Description
commit_referencestringRequiredThe commit ref, which can be a SHA, branch name, or tag name. Used to list check suites.
repository_namestringRequiredThe name of the repository to query. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository, case insensitive.
github_app_id_filterintegerOptionalFilter check suites by the GitHub App ID to narrow results to relevant checks associated with a specific application.
results_page_numberintegerOptionalSpecifies which page of results to fetch. Useful for paginating through a list of check suites.
results_per_pageintegerOptionalSpecify the number of results to return per page. The maximum is 100.
specific_check_namestringOptionalSpecify the name of the check run to filter the results.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'checks/list-suites-for-ref'.
#

GithubApi.ListChildTeams

Retrieves child teams of a specified team in an organization. Use this tool to get a list of child teams under a specific team within an organization on GitHub. It requires specifying the team by its slug and the organization name.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe organization's name. It's case insensitive and used to specify which organization's team structure to query.
team_identifier_slugstringRequiredThe slug of the team name for which to list child teams. This is used to uniquely identify the team within the organization.
page_numberintegerOptionalThe page number to retrieve in the list of child teams. Use to paginate the results.
results_per_pageintegerOptionalSpecify the number of results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/list-child-in-org'.
#

GithubApi.ListCodeownersErrors

Identify syntax errors in a repository's CODEOWNERS file. This tool checks a repository's CODEOWNERS file for any syntax errors. It's useful for ensuring that the file is correctly formatted and functioning as intended. Use this tool to diagnose issues with the CODEOWNERS file when configuring repository access controls.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. It is not case sensitive.
version_referencestringOptionalSpecify the branch, tag, or commit name to select the CODEOWNERS file version. Defaults to the repository's default branch if not provided.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/codeowners-errors'.
#

GithubApi.ListCodeScanningAlertInstances

Retrieve instances of a specific code scanning alert. Use this tool to list all instances of a given code scanning alert in a GitHub repository. This is useful for monitoring or analyzing alert occurrences. Requires appropriate access tokens with `security_events` or `public_repo` scope.

Parameters

ParameterTypeReq.Description
alert_identifierintegerRequiredThe unique number identifying the code scanning alert. Find this number at the end of the alert URL in GitHub or in the `GET /repos/{owner}/{repo}/code-scanning/alerts` response.
repository_namestringRequiredThe name of the repository, not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
git_referencestringOptionalThe Git reference for the results you want to list. Format as `refs/heads/<branch_name>` or `<branch_name>` for branches, and `refs/pull/<number>/merge` for pull requests.
page_numberintegerOptionalPage number of the results to fetch. Use for navigating large sets of alert instances.
results_per_pageintegerOptionalSpecify the number of results to return per page (maximum 100).

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'code-scanning/list-alert-instances'.
#

GithubApi.ListCodeScanningAlerts

Retrieve code scanning alerts for a repository. Retrieve a list of code scanning alerts for a specific GitHub repository, using an access token with the necessary permissions. Useful for monitoring code security issues in a repository.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository for which to list code scanning alerts. This name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
alert_state_filterstringOptionalFilter code scanning alerts by state. Valid options are 'open', 'closed', 'dismissed', and 'fixed'.
code_scanning_tool_guidstringOptionalThe GUID of a code scanning tool to filter alerts by this tool only. This can't be used with 'tool_name'.
code_scanning_tool_namestringOptionalSpecify the name of the code scanning tool to filter alerts by this tool only. Use either `tool_name` or `tool_guid`, but not both.
filter_by_severitystringOptionalSpecify the severity of code scanning alerts to filter, using values like 'critical', 'high', 'medium', 'low', 'warning', 'note', or 'error'.
git_reference_for_scan_resultsstringOptionalThe Git reference for listing results. Use `refs/heads/<branch>` or `<branch>` for branches, `refs/pull/<number>/merge` for pull requests.
results_page_numberintegerOptionalPage number to fetch results from. Use this to navigate through paginated results.
results_per_pageintegerOptionalThe number of results per page, up to a maximum of 100.
sort_by_propertystringOptionalProperty to sort the results by, either 'created' or 'updated'.
sort_directionstringOptionalThe direction to sort the results. Choose 'asc' for ascending or 'desc' for descending order.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'code-scanning/list-alerts-for-repo'.
#

GithubApi.ListCommitCommentReactions

Retrieve reactions for a GitHub commit comment. This tool fetches the list of reactions associated with a specific commit comment on GitHub. It should be called when you need to view reactions to a particular commit comment within a repository.

Parameters

ParameterTypeReq.Description
comment_idintegerRequiredThe unique identifier for the commit comment you want to retrieve reactions for.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive and identifies the repository within the specified owner's account.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
reaction_typestringOptionalFilter results to show only a specific reaction type. Omit to list all reactions.
results_page_numberintegerOptionalPage number of the results to fetch, used for pagination.
results_per_pageintegerOptionalSpecifies the number of results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/list-for-commit-comment'.
#

GithubApi.ListCommitComments

Retrieve comments for a specific commit in a GitHub repo. This tool fetches all comments associated with a specific commit in a given GitHub repository. It should be called when you need to view discussions or feedback on a specific code change identified by its commit SHA.

Parameters

ParameterTypeReq.Description
commit_shastringRequiredThe SHA string representing the specific commit to retrieve comments for.
repository_namestringRequiredThe case-insensitive name of the GitHub repository.
repository_ownerstringRequiredThe account owner of the repository. This is not case sensitive and identifies the GitHub user or organization that owns the repository.
results_page_numberintegerOptionalThe page number of results to fetch for commit comments. Useful for paginating through large sets of comments.
results_per_pageintegerOptionalThe number of comments to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-comments-for-commit'.
#

GithubApi.ListDependabotAlertsForOrganization

Lists Dependabot alerts for an organization. This tool lists Dependabot alerts for a specified organization. It requires you to be an organization owner or security manager with an appropriate access token. GitHub Apps need **Dependabot alerts** read permission. Use for monitoring security alerts related to dependencies.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe organization name for which to list Dependabot alerts. This name is not case sensitive.
alert_severity_filterstringOptionalComma-separated severities to filter alerts. Options: `low`, `medium`, `high`, `critical`.
alert_statesstringOptionalComma-separated list of alert states to filter by. Options: `dismissed`, `fixed`, `open`.
deprecated_first_results_page_sizeintegerOptional**Deprecated**. Use `per_page` with `after` instead. Specifies the number of results per page, up to 100, starting from the first matching result. Avoid using with `last`.
deprecated_last_results_per_pageintegerOptional**Deprecated**. Use this to specify the number of results per page (max 100) from the last matching result. Cannot be used with 'first'.
ecosystem_liststringOptionalComma-separated ecosystems to filter alerts. Options: composer, go, maven, npm, nuget, pip, pub, rubygems, rust.
package_namesstringOptionalA comma-separated list of package names. Only alerts for these specified packages will be returned.
paginate_after_cursorstringOptionalA cursor indicating the point to continue the listing from, based on the Link header.
results_before_cursorstringOptionalA cursor indicating to search for Dependabot alerts before this position.
results_per_pageintegerOptionalSpecifies the number of Dependabot alerts to return per page, with a maximum of 100.
sort_by_propertystringOptionalSort results by `created` (alert creation) or `updated` (state change).
sort_directionstringOptionalThe order to sort the results, either ascending ('asc') or descending ('desc').
vulnerable_dependency_scopestringOptionalSpecify the scope of the vulnerable dependency as either 'development' or 'runtime'. Only alerts with this scope will be returned.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/list-alerts-for-org'.
#

GithubApi.ListDependabotAlertsForRepo

Retrieve Dependabot alerts for a specific repository. Use this tool to get a list of Dependabot alerts for a given GitHub repository. It requires an access token with `security_events` scope for private repositories or `public_repo` scope for public repositories. Ideal for monitoring security vulnerabilities in repositories.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. This is case insensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. This name is not case sensitive.
alert_states_filterstringOptionalA comma-separated list of alert states to filter results by. Options: `dismissed`, `fixed`, `open`.
before_cursorstringOptionalCursor indicating the position to fetch results before this point.
cursor_afterstringOptionalA cursor to fetch results after a specified point. Helps in pagination by retrieving alerts following the given cursor position.
deprecated_page_numberintegerOptional**Deprecated**. Use to specify the page number of results to fetch. Prefer using `before` or `after` cursors.
ecosystem_filterstringOptionalComma-separated list of ecosystems to filter alerts by: composer, go, maven, npm, nuget, pip, pub, rubygems, rust.
fetch_deprecated_first_page_resultsintegerOptional**Deprecated**. Number of results per page (max 100), starting from the first result. Avoid using with `last`. Use `per_page` and `after` instead.
fetch_last_page_resultsintegerOptional**Deprecated**: Use `per_page` with `before` instead. Fetch results per page from the last result (max 100).
manifest_pathsstringOptionalComma-separated list of full manifest paths to filter alerts by those manifests.
package_namesstringOptionalA comma-separated list of package names. Only alerts for these packages will be returned.
results_per_pageintegerOptionalSpecifies the number of results to be returned per page, with a maximum limit of 100.
severity_filterstringOptionalProvide a comma-separated list of severities: `low`, `medium`, `high`, `critical`. Filters alerts by these severities.
sort_bystringOptionalSort alerts by `created` or `updated` date. `Created` means when the alert was created, `updated` means when the alert's state last changed.
sort_results_directionstringOptionalSpecify the order to sort the results: `asc` for ascending or `desc` for descending.
vulnerable_dependency_scopestringOptionalSpecifies the scope of the vulnerable dependency to filter alerts. Options: 'development' or 'runtime'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/list-alerts-for-repo'.
#

GithubApi.ListDeploymentBranchPolicies

Lists deployment branch policies for a GitHub environment. Use this tool to retrieve the branch policies associated with a specific environment in a GitHub repository. Accessible with read access; requires 'repo' scope for private repos.

Parameters

ParameterTypeReq.Description
environment_namestringRequiredThe name of the environment for which to list branch policies. This should match an existing environment in the repository.
repository_namestringRequiredThe name of the repository, not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Input is not case sensitive.
result_page_numberintegerOptionalThe page number of the results to retrieve. Use this to navigate through paginated results.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-deployment-branch-policies'.
#

GithubApi.ListEnterpriseCodeScanningAlerts

Retrieve code scanning alerts for enterprise repositories. This tool is used to list code scanning alerts for the default branch of all eligible repositories within an enterprise. It requires the user to be a member of the enterprise and have an access token with the necessary scopes (`repo` or `security_events`). Use this tool to monitor security alerts across repositories owned by organizations you manage as a security manager.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug version or ID of the enterprise. Used to specify which enterprise's alerts to list.
alert_state_filterstringOptionalFilter code scanning alerts by their state. Valid values are 'open', 'closed', 'dismissed', 'fixed'.
code_scanning_tool_guidstringOptionalThe GUID of a code scanning tool to filter alerts. Use either `code_scanning_tool_guid` or `code_scanning_tool_name`, but not both.
code_scanning_tool_namestringOptionalThe name of a code scanning tool to filter results. Use either this or `tool_guid`, but not both.
query_results_before_cursorstringOptionalThe cursor from the Link header to search for alerts before this point.
results_page_numberintegerOptionalSpecify the page number to fetch results from. Used for pagination of code scanning alerts.
results_per_pageintegerOptionalThe number of alerts to return per page, with a maximum of 100.
sort_directionstringOptionalSpecifies the sorting order of the results, either ascending ('asc') or descending ('desc').
sort_propertystringOptionalSpecify the property to sort the results by. Valid values are 'created' or 'updated'.
start_after_cursorstringOptionalSpecifies the cursor to return results after this point. Utilize the cursor from the Link header.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'code-scanning/list-alerts-for-enterprise'.
#

GithubApi.ListEnterpriseDependabotAlerts

Get Dependabot alerts for enterprise-owned repositories. This tool retrieves a list of Dependabot alerts for repositories owned by a specified enterprise on GitHub. It is used by members of the enterprise with appropriate access tokens. Alerts are restricted to organizations where the user is an owner or security manager.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID of the enterprise. This identifies the enterprise for which alerts are listed.
alert_severitiesstringOptionalA comma-separated list of alert severities to filter results. Options: `low`, `medium`, `high`, `critical`.
alert_state_filterstringOptionalComma-separated list of alert states to filter by: `dismissed`, `fixed`, `open`. Only alerts with these states will be returned.
before_cursorstringOptionalSpecify a cursor to fetch results before this point. Use the format provided in the Link header.
cursor_afterstringOptionalA cursor to return results after a specific point. Use as given in the Link header for pagination.
ecosystem_liststringOptionalA comma-separated list of ecosystems to filter alerts. Options include: `composer`, `go`, `maven`, `npm`, `nuget`, `pip`, `pub`, `rubygems`, `rust`.
number_of_results_per_page_starting_firstintegerOptional**Deprecated**. Specifies the number of results per page (maximum 100), beginning with the first matching result. Avoid using with `number_of_results_per_page_starting_last`. Use `results_per_page` with `paging_after_cursor` instead.
package_filterstringOptionalA comma-separated list of package names. Specify to filter alerts by these packages.
results_per_pageintegerOptionalThe number of results to return per page, with a maximum of 100.
results_per_page_starting_from_lastintegerOptional**Deprecated**. Number of results per page (max 100), starting from the last matching result. Avoid using with 'results_per_page_starting_from_first'.
sort_directionstringOptionalSpecifies the sorting order of the results, either ascending ('asc') or descending ('desc').
sort_property_for_alertsstringOptionalSpecifies the property to sort Dependabot alerts by. Options are 'created' (when the alert was created) or 'updated' (when the alert's state last changed).
vulnerable_dependency_scopestringOptionalThe scope of the vulnerable dependency to filter alerts by. Options: 'development', 'runtime'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/list-alerts-for-enterprise'.
#

GithubApi.ListExternalGroupsForOrg

Retrieve external groups available in a GitHub organization. Fetches a list of external groups for a specified organization. Use the `display_name` parameter to filter groups by name, and `per_page` for pagination.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
group_name_filterstringOptionalFilter results to include only groups with names containing this text.
pagination_tokenintegerOptionalToken to specify the starting point for the next set of results.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum value of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/list-external-idp-groups-for-org'.
#

GithubApi.ListFollowedUsers

Lists the people the authenticated user follows.

Parameters

ParameterTypeReq.Description
results_page_numberintegerOptionalSpecify the page number of the results you want to fetch.
results_per_pageintegerOptionalThe number of results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/list-followed-by-authenticated-user'.
#

GithubApi.ListFollowers

Retrieve followers of the authenticated user on GitHub. This tool retrieves a list of people who are following the authenticated GitHub user. Use it to access follower information for engagement or insights.

Parameters

ParameterTypeReq.Description
results_page_numberintegerOptionalSpecifies which page of followers to fetch. Used for pagination.
results_per_pageintegerOptionalSpecify the number of followers to list per page (maximum 100).

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/list-followers-for-authenticated-user'.
#

GithubApi.ListGistComments

Retrieve comments for a specific GitHub gist. This tool is used to fetch comments associated with a specified GitHub gist, identified by its gist ID.

Parameters

ParameterTypeReq.Description
gist_identifierstringRequiredProvide the unique identifier of the gist for which comments are to be listed.
result_page_numberintegerOptionalSpecifies the page number to fetch from the list of gist comments.
results_per_pageintegerOptionalThe number of comments to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/list-comments'.
#

GithubApi.ListGistCommits

Retrieve the commit history of a specified GitHub gist. Use this tool to obtain a list of all commits associated with a specific gist on GitHub. Ideal for tracking changes and updates made to the gist content over time.

Parameters

ParameterTypeReq.Description
gist_identifierstringRequiredThe unique identifier of the gist for which to list commits.
results_page_numberintegerOptionalSpecify the page number of results to fetch for pagination. Useful for accessing more than the default result set.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/list-commits'.
#

GithubApi.ListGistForks

Retrieve a list of forks for a specific gist. Use this tool to get information about the forks of a specific gist on GitHub by providing the gist ID.

Parameters

ParameterTypeReq.Description
gist_unique_identifierstringRequiredThe unique identifier of the gist to retrieve forks information from.
results_page_numberintegerOptionalSpecify the page number of the results you want to fetch. Used for pagination.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum of 100 allowed.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/list-forks'.
#

GithubApi.ListGithubActionsCaches

Retrieve the list of GitHub Actions caches for a repository. This tool fetches the list of GitHub Actions caches for a specified repository. It requires authentication with an access token having the 'repo' scope, or GitHub Apps must have the 'actions:read' permission.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This value is not case sensitive.
cache_key_or_prefixstringOptionalExplicit key or prefix to identify the cache. Use this to filter caches by specific keys or prefixes.
git_referencestringOptionalSpecify the Git reference for the results to list. Use `refs/heads/<branch>` for branches or `refs/pull/<number>/merge` for pull requests.
results_page_numberintegerOptionalThe page number of the results to fetch, used for pagination.
results_per_pageintegerOptionalSpecify the number of results to return per page, with a maximum of 100.
sort_by_propertystringOptionalThe property to sort results by. Options are 'created_at', 'last_accessed_at', or 'size_in_bytes'.
sort_directionstringOptionalSpecify 'asc' for ascending or 'desc' for descending order of results.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-actions-cache-list'.
#

GithubApi.ListGithubAppAccessibleRepos

List repositories accessible to a GitHub app installation. Use this tool to retrieve a list of repositories that a GitHub app installation can access. Requires an installation access token for authentication.

Parameters

ParameterTypeReq.Description
results_page_numberintegerOptionalPage number of the results to fetch.
results_per_pageintegerOptionalThe number of repositories to include on each page of results. Maximum is 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/list-repos-accessible-to-installation'.
#

GithubApi.ListGithubAppInstallations

Retrieve installations of a GitHub app using a JWT. Use this tool to get a list of all installations for a GitHub app. The response includes details about the permissions granted to each installation. This is useful for managing and auditing app installations.

Parameters

ParameterTypeReq.Description
include_outdatedstringOptionalInclude or exclude outdated installations in the results. Pass 'true' to include them.
notifications_updated_sincestringOptionalSpecify a timestamp in ISO 8601 format to filter installations updated after this time. Format: `YYYY-MM-DDTHH:MM:SSZ`.
results_page_numberintegerOptionalSpecify the page number of the results you want to retrieve, allowing pagination through the results. Useful for fetching specific subsets of data.
results_per_pageintegerOptionalSpecify the number of results to return per page. Maximum is 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/list-installations'.
#

GithubApi.ListGithubCheckRunsForSuite

List check runs for a GitHub check suite using its ID. This tool retrieves a list of check runs for a specified check suite in a GitHub repository. It requires appropriate permissions or scopes depending on the repository type.

Parameters

ParameterTypeReq.Description
check_suite_identifierintegerRequiredThe unique identifier of the check suite to list its check runs.
repository_namestringRequiredThe name of the GitHub repository to query. It is not case sensitive.
repository_ownerstringRequiredThe account owner's username of the repository. Case insensitive.
check_run_namestringOptionalReturns check runs with the specified name.
check_run_statusstringOptionalSpecify the status of the check runs to be returned. Options: 'queued', 'in_progress', 'completed'.
filter_by_completion_timestringOptionalFilters check runs by their `completed_at` timestamp. Use 'latest' for the most recent runs or 'all' for all runs.
result_page_numberintegerOptionalSpecifies which page of the results to fetch, for paginated data.
results_per_pageintegerOptionalSets the number of results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'checks/list-for-suite'.
#

GithubApi.ListGithubCustomRoles

Retrieve custom repository roles for a GitHub organization. Retrieve a list of available custom repository roles in a GitHub organization if authenticated as an organization owner or administrator with the appropriate permissions.

Parameters

ParameterTypeReq.Description
organization_idstringRequiredThe unique identifier of the GitHub organization to list custom roles for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/list-custom-roles'.
#

GithubApi.ListGithubDeployKeys

Retrieve deploy keys for a specific GitHub repository. This tool is used to retrieve the list of deploy keys associated with a specified GitHub repository, identified by its owner and repository name. It's useful for managing access controls and integrations.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive and identifies which repository's deploy keys are listed.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
result_page_numberintegerOptionalSpecify the page number of the deploy keys results to fetch.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-deploy-keys'.
#

GithubApi.ListGithubDeployments

Retrieve deployments from a GitHub repository. Use this tool to retrieve a list of deployments for a specific GitHub repository, with filtering options available through query parameters.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
commit_shastringOptionalThe commit SHA recorded at deployment creation time for filtering deployments.
deployment_environmentstringOptionalSpecify the environment that was deployed to, such as 'staging' or 'production'.
deployment_task_namestringOptionalThe specific task name for the deployment, like `deploy` or `deploy:migrations`.
repository_refstringOptionalThe name of the ref. This can be a branch, tag, or SHA to filter deployments by.
results_page_numberintegerOptionalSpecifies which page of deployment results to fetch. Used for pagination to navigate through multiple pages of results.
results_per_pageintegerOptionalThe number of results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-deployments'.
#

GithubApi.ListGithubDeploymentStatuses

Retrieve deployment statuses for a specified GitHub deployment. This tool is used to access and list the deployment statuses for a specific deployment on GitHub. It should be called when there is a need to review the status updates related to a deployment, and is accessible to users with pull access on the repository.

Parameters

ParameterTypeReq.Description
deployment_idintegerRequiredThe unique identifier of the deployment to retrieve statuses for. Must be an integer.
repository_namestringRequiredThe case-insensitive name of the GitHub repository.
repository_ownerstringRequiredThe GitHub username or organization that owns the repository. This is not case sensitive.
results_page_numberintegerOptionalThe specific page number of deployment statuses to fetch. Used for pagination.
results_per_pageintegerOptionalThe number of results to return per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-deployment-statuses'.
#

GithubApi.ListGithubEmojis

Lists all available GitHub emojis. Use this tool to retrieve a list of all emojis that can be used on GitHub Enterprise Server.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'emojis/get'.
#

GithubApi.ListGithubEnvironmentSecrets

Retrieve secrets for a GitHub environment. Use this tool to list all secrets in a specific GitHub environment without revealing their encrypted values. Authentication with a token having `repo` scope is required. Best used for managing or auditing environment secrets.

Parameters

ParameterTypeReq.Description
environment_namestringRequiredThe name of the environment whose secrets are to be listed. This is necessary to identify the specific environment in the repository.
repository_unique_identifierintegerRequiredThe unique identifier of the repository. Required to fetch the environment secrets.
results_page_numberintegerOptionalPage number of the results to fetch.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum allowable value of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-environment-secrets'.
#

GithubApi.ListGithubEnvironmentVariables

Retrieve environment variables from a GitHub repository's environment. Use this tool to list all environment variables for a specific environment within a GitHub repository. Requires authentication with a token having 'repo' scope or as a GitHub App with 'environments:read' permission.

Parameters

ParameterTypeReq.Description
environment_namestringRequiredSpecify the environment name to retrieve its variables within a GitHub repository.
repository_idintegerRequiredThe unique identifier of the GitHub repository to retrieve environment variables from.
results_page_numberintegerOptionalSpecify the page number to retrieve results from. Use for paginated results.
results_per_pageintegerOptionalSpecifies the number of environment variables to return per page, with a maximum allowed value of 30.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-environment-variables'.
#

GithubApi.ListGithubIssueAssignees

Retrieve available assignees for GitHub issues. This tool is used to list the available assignees for issues in a specified GitHub repository. Call this tool when you need to know who can be assigned to issues in a repository.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository, case insensitive.
repository_ownerstringRequiredThe owner of the repository. Input is not case sensitive.
results_page_numberintegerOptionalPage number of the results to fetch. Use to paginate through results.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum limit of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/list-assignees'.
#

GithubApi.ListGithubIssueComments

Retrieve comments for a specific GitHub issue. Use this tool to get all comments for a specific issue in a GitHub repository. It’s useful when you need to review discussions or updates on a particular issue.

Parameters

ParameterTypeReq.Description
issue_numberintegerRequiredThe unique number identifying the GitHub issue to retrieve comments for.
repository_namestringRequiredThe name of the GitHub repository (case insensitive).
repository_ownerstringRequiredThe account owner of the repository. Provide the username as a case-insensitive string.
page_numberintegerOptionalSpecify the page number of results to fetch when listing comments for pagination purposes.
results_per_pageintegerOptionalThe number of comments to retrieve per page, maximum 100.
since_timestampstringOptionalShow notifications updated after this time in ISO 8601 format (`YYYY-MM-DDTHH:MM:SSZ`).

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/list-comments'.
#

GithubApi.ListGithubIssueEvents

Retrieve events for a specific GitHub issue. This tool fetches a list of events related to a particular issue in a specified GitHub repository. It is useful for tracking changes, updates, and interactions associated with an issue.

Parameters

ParameterTypeReq.Description
issue_numberintegerRequiredThe number that identifies the issue within the repository. This is required to fetch the related events.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. This input is case insensitive.
results_page_numberintegerOptionalThe page number to fetch results from when listing issue events.
results_per_pageintegerOptionalThe number of issue events to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/list-events'.
#

GithubApi.ListGithubIssues

Get issues assigned to you across all GitHub repositories. This tool retrieves a list of issues that are assigned to the authenticated user from all visible repositories on GitHub, including owned, member, and organization repositories. It can be used to monitor workload and track tasks across projects. Note that the results may include pull requests as well, identified by a `pull_request` key.

Parameters

ParameterTypeReq.Description
include_collaborative_repositoriesbooleanOptionalInclude issues from collaborative repositories. Set to true to filter issues where you have collaborative access.
include_owned_repositoriesbooleanOptionalSet to true to include issues from repositories owned by the authenticated user.
include_pull_requestsbooleanOptionalSet to true to include pull requests in the issues list.
issue_filter_typestringOptionalSpecifies the type of issues to return: assigned, created, mentioned, subscribed, repos, or all.
issue_labelsstringOptionalComma-separated list of label names to filter issues. Example: 'bug,ui,@high'.
issue_statestringOptionalSpecifies the state of issues to retrieve: `open`, `closed`, or `all`.
organization_repositoriesbooleanOptionalInclude issues from organization repositories when set to true. If false, include issues from all repositories.
page_numberintegerOptionalThe specific page of results to fetch. Use this for pagination to navigate through large list of issues.
results_per_pageintegerOptionalThe number of results per page, maximum is 100.
sort_directionstringOptionalSpecifies the order of sorting for the results. Use 'asc' for ascending and 'desc' for descending.
sort_issues_bystringOptionalSpecify the criteria to sort issues by: 'created', 'updated', or 'comments'.
updated_since_timestampstringOptionalShow issues updated after this timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/list'.
#

GithubApi.ListGithubIssuesForRepo

Retrieve open issues from a GitHub repository. This tool lists open issues and pull requests in a specified GitHub repository. It is useful for tracking unresolved issues and ongoing work. The response includes both issues and pull requests.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository to fetch issues from. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
assignee_filterstringOptionalFilter issues by assignee. Use a username, `none` for unassigned, or `*` for any assignee.
issue_creatorstringOptionalThe GitHub username of the person who created the issue.
issue_labelsstringOptionalComma separated list of label names to filter issues, e.g., 'bug,ui,@high'.
issue_statestringOptionalIndicates the state of issues to retrieve: 'open', 'closed', or 'all'.
mentioned_userstringOptionalA GitHub username to filter issues where this user is mentioned.
milestone_identifierstringOptionalFilter issues by milestone. Use an integer for a specific milestone, "*" for any milestone, or "none" for no milestones.
results_page_numberintegerOptionalSpecifies which page of results to fetch. Use an integer value to navigate through paginated results.
results_per_pageintegerOptionalNumber of results per page, up to a maximum of 100.
sort_directionstringOptionalThe direction to sort the results by. Use 'asc' for ascending and 'desc' for descending.
sort_issues_bystringOptionalSpecify sorting criteria for issues: 'created', 'updated', or 'comments'.
updated_since_timestampstringOptionalOnly show issues or pull requests updated after this timestamp in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/list-for-repo'.
#

GithubApi.ListGithubMilestones

Retrieve milestones from a GitHub repository. Use this tool to list all milestones for a specified GitHub repository. Ideal for managing project timelines and tracking progress.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. The name is not case sensitive.
milestone_statestringOptionalDenotes the state of milestones to fetch: 'open', 'closed', or 'all'.
results_page_numberintegerOptionalThe page number of milestones results to fetch.
results_per_pageintegerOptionalThe number of results to display per page (maximum 100).
sort_directionstringOptionalThe direction for sorting milestones: 'asc' for ascending or 'desc' for descending order.
sort_milestonesstringOptionalCriteria to sort milestones by. Options include `due_on` for due date or `completeness` for progress.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/list-milestones'.
#

GithubApi.ListGithubOrganizations

Retrieve a list of GitHub organizations. Fetches all organizations from GitHub Enterprise Server in the order they were created. Supports pagination using the 'since' parameter.

Parameters

ParameterTypeReq.Description
organization_id_sinceintegerOptionalOnly return organizations with an ID greater than this value to paginate results.
results_per_pageintegerOptionalSpecifies the number of results to return per page, with a maximum value of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/list'.
#

GithubApi.ListGithubOrgSecrets

Retrieve Dependabot organization secrets from GitHub. Use this tool to list all Dependabot secrets of a GitHub organization without revealing their encrypted values. Requires authentication with an `admin:org` scope token or a GitHub App with `dependabot_secrets` permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name. It is not case sensitive.
results_page_numberintegerOptionalPage number to fetch results from in the paginated list of organization secrets.
results_per_pageintegerOptionalThe number of secrets to list per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/list-org-secrets'.
#

GithubApi.ListGithubPagesBuilds

Retrieve GitHub Pages build statuses for a repository. Call this tool to get a list of GitHub Pages build statuses for a specific repository on GitHub Enterprise Server. Useful for tracking build history and status.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository to fetch the Pages build statuses for. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository, case-insensitive.
results_page_numberintegerOptionalThe page number of the results to fetch. Use this to navigate through paginated results.
results_per_pageintegerOptionalThe number of results per page, with a maximum of 100 allowed.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-pages-builds'.
#

GithubApi.ListGithubProjectColumns

Retrieve columns of a specific GitHub project. Use this tool to get a list of columns for a specified GitHub project. It's useful when you need to know the structure or organization of a GitHub project board.

Parameters

ParameterTypeReq.Description
project_identifierintegerRequiredThe unique identifier of the GitHub project to list columns for.
page_numberintegerOptionalThe specific page number of the results to fetch from the GitHub project columns list.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/list-columns'.
#

GithubApi.ListGithubPublicEmails

Retrieve publicly visible GitHub emails for the authenticated user. This tool retrieves the publicly visible email addresses for the authenticated GitHub user. It's useful for applications needing to display or verify public contact details. Requires the `user:email` scope.

Parameters

ParameterTypeReq.Description
results_page_numberintegerOptionalThe page number of email results to retrieve. Use this to navigate through paginated email results.
results_per_pageintegerOptionalThe number of email results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/list-public-emails-for-authenticated-user'.
#

GithubApi.ListGithubPublicKeys

Retrieve GitHub Enterprise Admin public keys. Use this tool to obtain a list of public keys available for GitHub Enterprise Admin. Ideal for administrators needing to access or audit public keys.

Parameters

ParameterTypeReq.Description
filter_keys_accessed_sincestringOptionalSpecify a timestamp to only list public keys accessed after this time. Use ISO 8601 format.
page_number_to_fetchintegerOptionalThe specific page number of results to retrieve.
results_per_pageintegerOptionalThe number of results to display per page. Maximum allowed is 100. Use to limit the amount of data retrieved per call.
sort_directionstringOptionalThe direction to sort the results: 'asc' for ascending or 'desc' for descending.
sort_orderstringOptionalCriteria for sorting results. Options: 'created', 'updated', 'accessed'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/list-public-keys'.
#

GithubApi.ListGithubPullRequestFiles

Retrieve files changed in a GitHub pull request. Use this tool to list up to 3000 files altered in a specific pull request on GitHub. Useful for reviewing code changes or analyzing file modifications in a repository.

Parameters

ParameterTypeReq.Description
pull_request_numberintegerRequiredThe unique number identifying the pull request.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe GitHub username of the repository owner. This is not case sensitive.
results_page_numberintegerOptionalThe page number of the results to fetch, used for pagination.
results_per_pageintegerOptionalThe number of files to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/list-files'.
#

GithubApi.ListGithubPullRequestReviews

Retrieve reviews for a specific GitHub pull request. Use this tool to fetch a chronological list of reviews for a specified pull request within a GitHub repository. This can help in understanding the review history and comments made on the pull request.

Parameters

ParameterTypeReq.Description
pull_request_numberintegerRequiredThe unique identifier for the specific pull request to retrieve reviews for.
repository_namestringRequiredThe name of the GitHub repository, not case sensitive.
repository_ownerstringRequiredThe GitHub username or organization name of the repository owner. Not case sensitive.
results_page_numberintegerOptionalThe page number of the pull request reviews to fetch. Used for pagination.
results_per_pageintegerOptionalThe number of reviews per page (maximum 100). Specify an integer value.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/list-reviews'.
#

GithubApi.ListGithubReleaseAssets

Retrieve a list of assets for a GitHub release. This tool fetches and returns a list of assets associated with a specific release in a GitHub repository. It should be called when you need to access the files or resources attached to a particular release of a GitHub project.

Parameters

ParameterTypeReq.Description
release_identifierintegerRequiredThe unique identifier for the GitHub release to fetch assets from.
repository_namestringRequiredThe name of the GitHub repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. This is not case sensitive.
page_numberintegerOptionalThe specific page number to fetch from the list of release assets. Useful for navigation in paginated results.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum value of 100. This controls pagination.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-release-assets'.
#

GithubApi.ListGithubReleaseReactions

Retrieve reactions for a GitHub release. Call this tool to get a list of all reactions to a specific release on GitHub. Useful for analyzing user feedback or engagement with a particular release.

Parameters

ParameterTypeReq.Description
release_identifierintegerRequiredThe unique integer identifier of the GitHub release.
repository_namestringRequiredThe name of the GitHub repository. Case sensitivity is not required.
repository_ownerstringRequiredThe account owner of the GitHub repository. This name is not case sensitive.
reaction_type_filterstringOptionalSpecify a reaction type to filter results. Options are '+1', 'laugh', 'heart', 'hooray', 'rocket', 'eyes'. Leave empty to get all reactions.
results_page_numberintegerOptionalPage number of the results to fetch for paginated reactions.
results_per_pageintegerOptionalThe number of results to display per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/list-for-release'.
#

GithubApi.ListGithubRepoArtifacts

Retrieve all artifacts for a GitHub repository. Use this tool to get a list of all artifacts for a specific GitHub repository. It requires read access to the repository, and if private, an access token with the `repo` scope is needed. GitHub Apps require `actions:read` permission.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository to retrieve artifacts from. This input is not case sensitive.
repository_ownerstringRequiredThe username or organization name of the repository owner. This is not case sensitive.
filter_artifacts_by_namestringOptionalFilters artifacts by providing an exact match for the artifact name. Use a string to specify the artifact name.
result_page_numberintegerOptionalSpecify the page number of results to fetch for paginated artifact listings.
results_per_pageintegerOptionalSpecify the number of artifacts to return per page, with a maximum limit of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-artifacts-for-repo'.
#

GithubApi.ListGithubRepoBranches

Retrieve branches from a specific GitHub repository. Use this tool to get a list of all branches in a specified GitHub repository. It requires specifying the repository owner and name.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is not case-sensitive.
results_page_numberintegerOptionalPage number of the results to fetch from the list of branches.
results_per_pageintegerOptionalSpecify the number of branch results per page (maximum 100).
return_only_protected_branchesbooleanOptionalSet to `true` to return only protected branches, `false` for only unprotected, or omit to return all branches.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-branches'.
#

GithubApi.ListGithubRepoCollaborators

Retrieve collaborators of a GitHub repository. Use this tool to get the list of collaborators for a GitHub repository, including organization members and outside collaborators. Useful for understanding who has access and their roles. Requires specific authentication permissions.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. This name is not case sensitive.
filter_by_affiliationstringOptionalFilter collaborators by affiliation: 'outside', 'direct', or 'all'.
filter_by_permissionstringOptionalSpecify the permission level ('pull', 'triage', 'push', 'maintain', 'admin') to filter the repository collaborators. Returns all collaborators if not specified.
results_page_numberintegerOptionalThe page number of results to retrieve when querying the list of collaborators.
results_per_pageintegerOptionalThe number of results per page to return, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-collaborators'.
#

GithubApi.ListGithubRepoContributors

Retrieve contributors for a specific GitHub repository. This tool lists contributors to a specified GitHub repository, sorted by the number of commits in descending order. It captures contributions by GitHub user, including associated email addresses, but may include anonymous contributors without GitHub user details due to performance optimization limits.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. This value is not case sensitive.
include_anonymous_contributorsstringOptionalSet to `1` or `true` to include anonymous contributors in the results.
results_page_numberintegerOptionalSpecifies the page number of contributors to fetch. Use this to navigate through paginated results. Each page contains a subset of contributors, with 'per_page' controlling the number of contributors per page.
results_per_pageintegerOptionalThe number of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-contributors'.
#

GithubApi.ListGithubRepoEvents

Retrieve GitHub repository events. Use this tool to list events from a specific GitHub repository. It helps track recent activities such as pushes, issues, and other event types.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. The name is not case sensitive.
repository_owner_namestringRequiredThe username of the account owner of the repository, case insensitive.
results_page_numberintegerOptionalSpecify the page number of the repository events to fetch. Useful for paginating results.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum limit of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/list-repo-events'.
#

GithubApi.ListGithubRepoForks

Fetches the list of forks for a specified GitHub repository. This tool retrieves a list of forks for a given GitHub repository, identified by its owner and name. It should be called when you need to obtain information about the forks of a particular repository.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is not case sensitive and specifies whose repository to list forks from.
results_page_numberintegerOptionalSpecifies the page number for paginated results when listing forks.
results_per_pageintegerOptionalThe number of results to return per page, with a maximum of 100.
sort_orderstringOptionalThe order to sort the forks. Options: 'newest', 'oldest', 'stargazers', or 'watchers'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-forks'.
#

GithubApi.ListGithubRepoIssueEvents

Retrieve events for issues in a GitHub repository. Use this tool to get a list of events related to issues for a specific GitHub repository. It's useful for tracking changes and actions performed on issues.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredSpecify the account owner of the GitHub repository. The name is not case sensitive.
results_page_numberintegerOptionalSpecifies the page number of the issue events results to fetch from the repository.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/list-events-for-repo'.
#

GithubApi.ListGithubRepoSecretAlerts

Retrieve secret scanning alerts for a GitHub repository. Call this tool to get a list of secret scanning alerts for a specified GitHub repository. It requires administrator access and a personal access token with proper scopes (repo or security_events). Suitable for monitoring sensitive data exposure in repositories.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. The name is not case sensitive.
alerts_state_filterstringOptionalFilter alerts by their state: `open` or `resolved`. Specify to list only alerts in a specific state.
cursor_before_eventstringOptionalSearch for events only before this cursor. Leave empty to get the initial cursor.
events_after_cursorstringOptionalA cursor for paginated results to fetch events occurring after this point. Use an empty value to receive the initial cursor.
filter_by_secret_typestringOptionalComma-separated list of secret types to return. By default, all secret types are included.
results_page_numberintegerOptionalSpecifies the page number of the secret scanning alerts to retrieve. Use this to paginate results.
results_per_pageintegerOptionalSpecifies the number of secret scanning alerts to return per page, with a maximum of 100 items.
secret_alert_resolutions_filterstringOptionalComma-separated resolutions to filter alerts. Valid values: `false_positive`, `wont_fix`, `revoked`, `pattern_edited`, `pattern_deleted`, `used_in_tests`.
sort_directionstringOptionalSpecifies the direction to sort the results ('asc' for ascending, 'desc' for descending).
sort_results_by_propertystringOptionalSpecifies the property to sort alerts: use 'created' for creation date, or 'updated' for last update or resolution date.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'secret-scanning/list-alerts-for-repo'.
#

GithubApi.ListGithubRepoTags

Retrieve tags for a specified GitHub repository. Use this tool to get a list of all tags for a particular GitHub repository. It's helpful when you need to see available versions or releases in the repository.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository to retrieve tags from. This is not case sensitive.
repository_ownerstringRequiredThe GitHub username or organization that owns the repository. Case insensitive.
page_numberintegerOptionalThe page number to fetch the results from for the list of repository tags.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-tags'.
#

GithubApi.ListGithubRepoVariables

Retrieve all variables for a specified GitHub repository. Use this tool to list all variables associated with a specific GitHub repository. Requires authentication with an access token having the 'repo' scope or a GitHub App with 'actions_variables:read' permission.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository, case insensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
page_numberintegerOptionalPage number to fetch in the list of repository variables. Use for paginating results.
results_per_pageintegerOptionalSpecify the number of results to return per page, with a maximum of 30.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-repo-variables'.
#

GithubApi.ListGithubRepoWorkflows

Retrieve GitHub workflows in a repository. This tool retrieves the list of workflows for a specified GitHub repository. It requires read access to the repository. For private repositories, an access token with the `repo` scope is needed, and GitHub Apps must have `actions:read` permission.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This field is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. Case insensitive.
results_page_numberintegerOptionalThe page number for pagination, used to fetch specific sets of results.
results_per_pageintegerOptionalThe number of workflow results to display per page, with a maximum limit of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-repo-workflows'.
#

GithubApi.ListGithubRunnerBinariesForOrg

Retrieve downloadable binaries for GitHub runner application. This tool lists the binaries for the GitHub runner application that can be downloaded and run for a specified organization. Authentication with an access token having the `admin:org` scope is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. The organization name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-runner-applications-for-org'.
#

GithubApi.ListGithubUserPublicEvents

Retrieve a GitHub user's public events. This tool retrieves the list of public events for a specified GitHub user. Use it to check user activity on GitHub, such as recent contributions and interactions.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user's handle to retrieve public events for.
page_numberintegerOptionalThe page number of the results to retrieve. Use to navigate through paginated results.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/list-public-events-for-user'.
#

GithubApi.ListGithubUsers

Retrieve a list of all GitHub users by signup order. This tool retrieves a list of all users from GitHub Enterprise Server, including both personal and organization accounts, sorted by their signup date. Pagination is controlled using the 'since' parameter.

Parameters

ParameterTypeReq.Description
results_per_pageintegerOptionalThe number of results to return per page, with a maximum of 100 allowed.
user_id_thresholdintegerOptionalA user ID. Only return users with an ID greater than this number.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/list'.
#

GithubApi.ListGithubWebhookDeliveries

Fetch webhook delivery events for a specific GitHub repository. Use this tool to retrieve a list of webhook deliveries for a specific webhook configured in a GitHub repository. It is useful for monitoring and debugging webhook events.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository (case insensitive).
repository_ownerstringRequiredThe account owner of the repository. Not case sensitive.
webhook_hook_idintegerRequiredThe unique identifier of the webhook. This is necessary to fetch the specific webhook deliveries for the repository.
include_redelivered_eventsbooleanOptionalInclude redelivered webhook events in the results if set to true.
pagination_start_cursorstringOptionalThe starting point for fetching the page of deliveries. Use the `link` header for next/previous page cursors.
results_per_pageintegerOptionalThe maximum number of webhook delivery results to fetch per page, up to 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-webhook-deliveries'.
#

GithubApi.ListGithubWorkflowJobs

Fetches jobs for a specific GitHub workflow run. Use this tool to retrieve jobs associated with a GitHub workflow run. Requires read access to the repository. For private repositories, an access token with the `repo` scope is needed. GitHub Apps must have the `actions:read` permission. Parameters can be used to filter results.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. It is not case sensitive and identifies whose account owns the repository.
workflow_run_idintegerRequiredThe unique identifier of the GitHub workflow run to fetch jobs for.
job_filter_by_completion_timestringOptionalFilter jobs by their `completed_at` timestamp. Use 'latest' for the most recent execution or 'all' for all executions.
results_page_numberintegerOptionalPage number for paginated results to fetch from the workflow jobs list.
results_per_pageintegerOptionalSpecify the number of job results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-jobs-for-workflow-run'.
#

GithubApi.ListGithubWorkflowRuns

Retrieve all workflow runs for a GitHub repository. This tool retrieves a list of all workflow runs for a specified GitHub repository. It can be used to track the status and history of workflows in the repository. Works with repositories you have read access to. For private repositories, an access token with the 'repo' scope is needed.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository (case insensitive).
repository_ownerstringRequiredThe GitHub username or organization name that owns the repository. It is case-insensitive.
actor_usernamestringOptionalSpecify the username of the user whose workflow runs you want to retrieve. Use the login of the user who initiated the run.
branch_namestringOptionalSpecify the branch name to filter workflow runs associated with that branch.
check_suite_idintegerOptionalReturns workflow runs with the specified check suite ID.
filter_by_head_shastringOptionalOnly returns workflow runs associated with the specified commit SHA (head_sha).
omit_pull_requestsbooleanOptionalIf true, pull requests are excluded from the workflow runs response.
results_page_numberintegerOptionalPage number of the results to fetch, used for paginating results.
results_per_pageintegerOptionalThe number of results to return per page, with a maximum limit of 100.
triggering_eventstringOptionalSpecify the event that triggers the workflow run, such as 'push', 'pull_request', or 'issue'.
workflow_created_date_rangestringOptionalSpecify a date-time range to filter workflow runs by creation date. Use GitHub's specific date syntax for format.
workflow_run_statusstringOptionalSpecifies the desired status or conclusion of the workflow runs to retrieve, such as 'success', 'in_progress', etc.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-workflow-runs-for-repo'.
#

GithubApi.ListGitignoreTemplates

Retrieve all available .gitignore templates from GitHub. Use this tool to obtain a list of all .gitignore templates that can be used when creating a new repository on GitHub. This can help in setting up repositories with the appropriate exclusions.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gitignore/get-all-templates'.
#

GithubApi.ListGitMatchingRefs

Retrieve Git references matching a specific name pattern. This tool returns an array of Git references from a repository that match a specified name. It supports branches and tags, and can return refs that start with the given pattern if no exact match is found. It includes all references, such as notes and stashes, when no specific ref is provided.

Parameters

ParameterTypeReq.Description
reference_patternstringRequiredThe pattern to match against Git references (e.g., heads/branch or tags/tag). Leave empty to retrieve all references.
repository_namestringRequiredThe name of the repository to search for references. This name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive. Specify the username or organization name that owns the repository.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'git/list-matching-refs'.
#

GithubApi.ListGitRepoSecrets

Retrieve a list of secrets in a GitHub repository. This tool lists all secrets available in a specified GitHub repository without revealing their encrypted values. It requires authentication with an access token with the 'repo' scope or GitHub Apps permission 'dependabot_secrets'.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
results_page_numberintegerOptionalSpecifies the page number of results to retrieve from the repository secrets list.
results_per_pageintegerOptionalThe number of secret results to display per page, maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/list-repo-secrets'.
#

GithubApi.ListGlobalWebhooks

Retrieve a list of global webhooks from GitHub Enterprise. Use this tool to obtain a list of all global webhooks configured in a GitHub Enterprise environment. Ideal for administrators managing hooks across the entire enterprise.

Parameters

ParameterTypeReq.Description
page_numberintegerOptionalSpecify the page number of the results to fetch. This is used to navigate through paginated results.
results_per_pageintegerOptionalThe number of results to include in each page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/list-global-webhooks'.
#

GithubApi.ListGpgKeysForUser

Retrieve public GPG keys for a GitHub user. Use this tool to list the public GPG keys associated with a GitHub user. This information is publicly accessible and can be used to verify the integrity of a user's signed content.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub username of the account to retrieve GPG keys for.
page_numberintegerOptionalPage number of the results to fetch. Used for pagination.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/list-gpg-keys-for-user'.
#

GithubApi.ListIssueCommentReactions

Retrieve reactions for a GitHub issue comment. This tool retrieves the list of reactions for a specific comment on an issue in a GitHub repository. It should be called when you need to know how users have reacted to a particular issue comment.

Parameters

ParameterTypeReq.Description
comment_idintegerRequiredThe unique identifier for the specific issue comment whose reactions are to be listed.
repository_namestringRequiredThe name of the repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This value is not case sensitive.
reaction_typestringOptionalSpecify a single reaction type to filter results. Use values like '+1', '-1', 'laugh', etc. Omit to list all reactions.
results_page_numberintegerOptionalPage number of results to fetch from the reactions list.
results_per_pageintegerOptionalThe number of reactions to retrieve per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/list-for-issue-comment'.
#

GithubApi.ListIssueComments

Fetch comments for all issues in a repository. Use this tool to retrieve all comments from issues in a specified GitHub repository. Comments are ordered by ascending ID.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository, not case sensitive.
results_page_numberintegerOptionalThe page number of results to fetch for issue comments in a repository.
results_per_pageintegerOptionalSpecify the number of results to display per page, up to a maximum of 100.
sort_directionstringOptionalSets the sorting order, `asc` for ascending or `desc` for descending, used with `sort`.
sort_propertystringOptionalThe property to sort the issue comments by. Use 'created' for when the repo was starred or 'updated' for last push.
updated_after_timestampstringOptionalFilter comments updated after this timestamp in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/list-comments-for-repo'.
#

GithubApi.ListIssueReactions

Retrieve reactions from a GitHub issue. This tool retrieves the list of reactions for a specified issue in a GitHub repository. It should be called when you need to understand the community's reactions to a particular issue.

Parameters

ParameterTypeReq.Description
issue_numberintegerRequiredThe number that identifies the issue in the GitHub repository.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
reaction_type_to_filterstringOptionalFilter reactions by a specific type (e.g., '+1', 'heart'). Omit to list all reactions.
results_page_numberintegerOptionalSpecify the page number of results to fetch. Useful for pagination through large result sets.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/list-for-issue'.
#

GithubApi.ListLabelsForMilestone

Retrieve labels for issues in a specific milestone on GitHub. Use this tool to get a list of labels applied to issues within a specific milestone in a GitHub repository. Ideal for tracking or categorizing issues based on milestone labels.

Parameters

ParameterTypeReq.Description
milestone_numberintegerRequiredThe number that uniquely identifies the milestone in the repository.
repository_namestringRequiredThe name of the repository for which to list milestone labels. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
results_page_numberintegerOptionalSpecify the page number of results to fetch for listing milestone labels.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum limit of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/list-labels-for-milestone'.
#

GithubApi.ListLabelsForRunner

Retrieve all labels for a self-hosted runner in an enterprise. Use this tool to get a list of all labels associated with a specific self-hosted runner within an enterprise on GitHub. Authentication with an access token having `manage_runners:enterprise` scope is required.

Parameters

ParameterTypeReq.Description
enterprise_slug_or_idstringRequiredThe slug or ID of the enterprise for identifying self-hosted runner.
runner_idintegerRequiredUnique identifier of the self-hosted runner for which to list labels.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/list-labels-for-self-hosted-runner-for-enterprise'.
#

GithubApi.ListLabelsOnGithubIssue

Retrieve all labels associated with a GitHub issue. Use this tool to get all labels on a specific GitHub issue by providing the repository owner, repository name, and issue number.

Parameters

ParameterTypeReq.Description
issue_numberintegerRequiredThe unique identifier for the GitHub issue you wish to retrieve labels for.
repository_namestringRequiredThe name of the repository. It is not case sensitive and identifies where the issue is located.
repository_ownerstringRequiredThe account owner of the repository. Provide a non-case-sensitive string.
results_page_numberintegerOptionalThe page number of results to fetch from the GitHub API for an issue's labels.
results_per_pageintegerOptionalNumber of labels to retrieve per page, maximum is 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/list-labels-on-issue'.
#

GithubApi.ListLinkedExternalGroups

Retrieve connections between a GitHub team and external groups. Use this tool to list connections between a specific GitHub team and external identity provider groups within an organization. Ideal for managing team membership using Enterprise Managed Users for GitHub Enterprise Cloud.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
team_slugstringRequiredSlug of the team name to identify the specific GitHub team.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/list-linked-external-idp-groups-to-team-for-org'.
#

GithubApi.ListOrgAccessRunnerGroup

List organizations with access to a self-hosted runner group. Retrieves a list of organizations that have access to a specific self-hosted runner group in an enterprise. Requires authentication with a token that has 'manage_runners:enterprise' scope.

Parameters

ParameterTypeReq.Description
enterprise_slug_or_idstringRequiredThe slug or ID of the enterprise. Used to identify the specific enterprise context for the runner group.
runner_group_idintegerRequiredUnique identifier for the self-hosted runner group.
page_numberintegerOptionalSpecify the page number of results to fetch. Useful for pagination in large datasets.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/list-org-access-to-self-hosted-runner-group-in-enterprise'.
#

GithubApi.ListOrganizationIssuesForUser

Retrieve issues and pull requests for a user in an organization. Call this tool to list all issues and pull requests assigned to the authenticated user within a specific organization on GitHub. This tool returns both issues and pull requests, identifiable by the `pull_request` key. It is useful for tracking user-specific tasks within an organization.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
issue_filterstringOptionalSpecifies the type of issues to return: 'assigned', 'created', 'mentioned', 'subscribed', 'all', or 'repos'.
issue_labelsstringOptionalComma-separated list of label names to filter issues. Example: `bug,ui,@high`.
issues_statestringOptionalSpecify the state of issues to return: 'open', 'closed', or 'all'.
result_page_numberintegerOptionalPage number of results to fetch, used for pagination. Starts from 1.
results_per_pageintegerOptionalThe number of results to display per page (maximum 100).
sort_criteriastringOptionalDefines the attribute to sort the issues by. Options are 'created', 'updated', or 'comments'.
sort_directionstringOptionalThe direction to sort the results by. Accepted values are 'asc' for ascending and 'desc' for descending.
updated_sincestringOptionalFilter to show notifications updated after this timestamp in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/list-for-org'.
#

GithubApi.ListOrganizationMemberships

Retrieve organization memberships for the authenticated user. This tool retrieves a list of organization memberships for the authenticated user on GitHub, detailing their involvement in various organizations.

Parameters

ParameterTypeReq.Description
membership_statestringOptionalFilter memberships by state: 'active' or 'pending'. Returns both if unspecified.
results_page_numberintegerOptionalSpecify the page number of results to fetch, for pagination.
results_per_pageintegerOptionalNumber of results per page. Maximum allowed is 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/list-memberships-for-authenticated-user'.
#

GithubApi.ListOrganizationProjects

Retrieve a list of projects for a given organization on GitHub. Use this tool to obtain a list of projects within a specified GitHub organization. It returns an error if projects are disabled or if access is unauthorized.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe case-insensitive name of the GitHub organization for which to list projects.
project_statestringOptionalSpecifies the state of projects to return: 'open', 'closed', or 'all'.
results_page_numberintegerOptionalSpecifies the page number of the results to fetch for organization projects.
results_per_pageintegerOptionalThe number of project results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/list-for-org'.
#

GithubApi.ListOrganizationRepositories

Retrieve repositories for a specific organization on GitHub. Fetches a list of repositories belonging to a specified organization on GitHub. Admin permissions or ownership may be required to access certain repository details.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
page_numberintegerOptionalPage number of the results to fetch, used for pagination.
repository_typestringOptionalSpecify the type of repositories to return, such as 'all', 'public', 'private', etc. Note: 'internal' is unsupported with an installation access token.
results_per_pageintegerOptionalThe number of repository results to display per page, with a maximum limit of 100.
sort_orderstringOptionalSpecifies the sorting order of the results. Use 'asc' for ascending or 'desc' for descending.
sort_propertystringOptionalSpecifies the property to sort the repository results by, such as created, updated, pushed, or full_name.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-for-org'.
#

GithubApi.ListOrganizationSecrets

Retrieve all organization secrets without values. This tool fetches a list of all secrets available in a GitHub organization without revealing their encrypted values. It requires authentication with an access token possessing the `admin:org` scope. Ideal for managing and reviewing organization secrets.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name to list secrets for. This name is not case-sensitive.
page_numberintegerOptionalPage number of the results to fetch for pagination purposes.
results_per_pageintegerOptionalSpecify the number of secrets to list per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-org-secrets'.
#

GithubApi.ListOrganizationTeams

Retrieve teams visible to the user in a GitHub organization. Use this tool to list all teams within a specified GitHub organization that the authenticated user can see.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name. It is not case sensitive.
results_page_numberintegerOptionalPage number of the results to fetch from the list of teams.
results_per_pageintegerOptionalSpecify the number of results per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/list'.
#

GithubApi.ListOrganizationWebhooks

Retrieve the webhooks for a specific organization on GitHub. Call this tool to get a list of configured webhooks for a specified GitHub organization. Useful for checking webhook integrations and statuses.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name. This parameter is case insensitive.
result_page_numberintegerOptionalThe specific page number of results to retrieve from the list of organization webhooks.
results_per_pageintegerOptionalThe number of webhook results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/list-webhooks'.
#

GithubApi.ListOrgCodeScanningAlerts

Retrieve code scanning alerts for an organization's repositories. This tool lists code scanning alerts for the default branch of all eligible repositories within a specified organization. It requires the user to be an owner or security manager of the organization, and access tokens with the necessary scopes (`repo`, `security_events`, or `public_repo` for public repositories).

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. This field is not case sensitive.
alert_severitystringOptionalSpecifies the severity of code scanning alerts to be returned. Acceptable values include 'critical', 'high', 'medium', 'low', 'warning', 'note', and 'error'.
alert_statestringOptionalFilter code scanning alerts by their state: 'open', 'closed', 'dismissed', or 'fixed'.
code_scanning_tool_guidstringOptionalThe GUID of a specific code scanning tool. Use this to filter alerts by the tool. Must not use with `tool_name`.
cursor_beforestringOptionalA cursor used to fetch results occurring before this point in the data timeline.
filter_by_tool_namestringOptionalSpecify the name of a code scanning tool to filter results. Only alerts from this tool will be listed. Ensure not to use `tool_guid` if this is specified.
results_after_cursorstringOptionalA cursor indicating the point after which to retrieve results. Used for pagination.
results_page_numberintegerOptionalThe page number of the results to fetch from the list of code scanning alerts.
results_per_pageintegerOptionalThe number of results per page, with a maximum limit of 100.
sort_directionstringOptionalSpecifies the sort order of the results. Use 'asc' for ascending or 'desc' for descending.
sort_results_bystringOptionalSpecifies the property by which to sort the results. Options are 'created' or 'updated'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'code-scanning/list-alerts-for-org'.
#

GithubApi.ListOrgMembers

Retrieve members of a GitHub organization. Use this tool to list all users who are members of a specified GitHub organization, including both concealed and public members if authenticated.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization to list members from. It is not case sensitive.
filter_membersstringOptionalFilter the list of members. Use '2fa_disabled' to list members without two-factor authentication.
member_role_filterstringOptionalFilter members by their role in the organization ('all', 'admin', 'member').
page_numberintegerOptionalPage number of the results to fetch. Use this to navigate through paginated results.
results_per_pageintegerOptionalNumber of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/list-members'.
#

GithubApi.ListOrgOutsideCollaborators

Retrieve outside collaborators for a GitHub organization. Use this tool to fetch a list of users who are outside collaborators for a specified GitHub organization.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name, not case sensitive.
filter_outside_collaboratorsstringOptionalSpecify '2fa_disabled' to filter for collaborators without two-factor authentication, or 'all' for all collaborators.
result_page_numberintegerOptionalSpecify the page number to fetch results from the list of outside collaborators.
results_per_pageintegerOptionalSpecify the number of results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/list-outside-collaborators'.
#

GithubApi.ListOrgPreReceiveHooks

Retrieve pre-receive hooks for a GitHub organization. Use this tool to list all pre-receive hooks that are enabled, testing, or configurable at an organization level in GitHub. It excludes globally disabled hooks with no downstream configuration options.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case-sensitive.
page_numberintegerOptionalPage number of the results to fetch. Use this to navigate through paginated results.
results_per_pageintegerOptionalThe number of results to return per page. The maximum allowed is 100.
sort_directionstringOptionalThe direction to sort the results by. Accepts 'asc' or 'desc'.
sort_orderstringOptionalSpecify the sort order for the response: options are 'created', 'updated', or 'name'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/list-pre-receive-hooks-for-org'.
#

GithubApi.ListOrgRunnerGroupRunners

List self-hosted runners in an organization group. Retrieves self-hosted runners in a specified group within an organization. Requires an access token with 'admin:org' scope.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. It is not case sensitive.
runner_group_idintegerRequiredUnique identifier of the self-hosted runner group to fetch runners for.
result_page_numberintegerOptionalSpecifies the page number of results to be fetched. Used for pagination.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-self-hosted-runners-in-group-for-org'.
#

GithubApi.ListOrgSecretScanningAlerts

Retrieve secret scanning alerts for an organization's repositories. This tool provides a list of secret scanning alerts from eligible repositories within an organization, sorted from newest to oldest. It should be called by users who are administrators or security managers of the organization, using an appropriate access token. GitHub Apps with `secret_scanning_alerts` read permission can also utilize this endpoint.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization for which secret scanning alerts are to be listed. This value is not case-sensitive.
alert_resolution_filterstringOptionalA comma-separated list of resolutions to filter secret scanning alerts. Valid options are `false_positive`, `wont_fix`, `revoked`, `pattern_edited`, `pattern_deleted`, and `used_in_tests`.
alert_statestringOptionalSpecify 'open' or 'resolved' to filter secret scanning alerts by their state.
results_page_numberintegerOptionalThe page number of results to retrieve, starting from 1. Determines which subset of results will be returned.
results_per_pageintegerOptionalThe number of results to return per page, with a maximum of 100.
search_after_cursorstringOptionalA cursor for paginating results, provided in the Link header. Use an empty string for the initial request to receive a starting cursor.
search_before_cursorstringOptionalA cursor indicating that the query should only look for events before this point. Use an empty string to get an initial cursor.
secret_typesstringOptionalComma-separated list of secret types to return. Defaults to all secret types. Refer to the GitHub documentation for details on secret types.
sort_by_propertystringOptionalChoose 'created' to sort by alert creation date or 'updated' to sort by last update or resolution.
sort_directionstringOptionalSpecifies the order to sort the results: ascending ('asc') or descending ('desc').

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'secret-scanning/list-alerts-for-org'.
#

GithubApi.ListOrgSelfHostedRunners

Retrieve self-hosted runners for a GitHub organization. This tool fetches all self-hosted runners configured for a specified GitHub organization. Authentication with an admin-level token is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization's name. This is case insensitive.
results_page_numberintegerOptionalSpecify the page number of the results to fetch. For paginated data retrieval.
results_per_pageintegerOptionalSpecify the number of results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-self-hosted-runners-for-org'.
#

GithubApi.ListOrgVariables

Retrieve all variables for a GitHub organization. Use this tool to list all variables configured in a GitHub organization. Authentication with an access token having the `admin:org` scope or a GitHub App with `organization_actions_variables:read` permission is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
result_page_numberintegerOptionalSpecify the page number of the organization variables to retrieve.
results_per_pageintegerOptionalThe number of results to display per page, up to a maximum of 30.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-org-variables'.
#

GithubApi.ListPersonalAccessTokens

Retrieve personal access tokens for all users including admins. This tool calls the GitHub API to list personal access tokens for all users in an enterprise, including admin users. It's useful for administrators wanting to audit or manage user access tokens.

Parameters

ParameterTypeReq.Description
results_page_numberintegerOptionalThe page number of the results to fetch, used for pagination.
results_per_pageintegerOptionalNumber of results to return per page. Maximum value is 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/list-personal-access-tokens'.
#

GithubApi.ListPreReceiveEnvironments

Retrieve a list of pre-receive environments for GitHub Enterprise. This tool is used to fetch and list all pre-receive environments in a GitHub Enterprise instance. It should be called when you need to inspect or manage pre-receive environments.

Parameters

ParameterTypeReq.Description
page_numberintegerOptionalSpecifies the page number of results to fetch. Use this to navigate through paginated data.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum of 100.
sortstringOptionalCriteria to sort the results: 'created', 'updated', or 'name'.
sort_directionstringOptionalSpecifies the order to sort results: 'asc' for ascending or 'desc' for descending.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/list-pre-receive-environments'.
#

GithubApi.ListPreReceiveHooks

Retrieve the list of pre-receive hooks in GitHub Enterprise. Use this tool to get a list of all the pre-receive hooks configured in the GitHub Enterprise admin settings.

Parameters

ParameterTypeReq.Description
results_page_numberintegerOptionalThe specific page number of results to retrieve, used for pagination.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum of 100.
sort_directionstringOptionalThe direction to sort the results by. Options are 'asc' for ascending or 'desc' for descending.
sort_results_bystringOptionalSpecify the property to sort the results by. Options are 'created', 'updated', or 'name'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/list-pre-receive-hooks'.
#

GithubApi.ListProjectCards

Retrieve project cards for a specific column on GitHub projects. Use this tool to obtain a list of project cards within a specified column in GitHub projects. It is useful for managing tasks and tracking project progress by accessing detailed card information in a particular column.

Parameters

ParameterTypeReq.Description
column_identifierintegerRequiredThe unique identifier for the specified project column, used to list its cards.
filter_by_archived_statestringOptionalFilters project cards by their archived state. Options are 'all', 'archived', or 'not_archived'.
results_page_numberintegerOptionalSpecifies the page number of the project cards results to fetch. Useful for navigating through paginated results.
results_per_pageintegerOptionalNumber of project cards returned per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/list-cards'.
#

GithubApi.ListProjectCollaborators

Retrieve collaborators for a GitHub organization project. Use this tool to obtain a list of all collaborators for a specified GitHub organization project, including outside collaborators and organization members with various access levels. Requires organization owner or project admin permissions.

Parameters

ParameterTypeReq.Description
project_idintegerRequiredThe unique identifier for the GitHub organization project to retrieve collaborators for.
collaborator_affiliation_filterstringOptionalSpecifies how to filter collaborators: `outside`, `direct`, or `all`.
results_page_numberintegerOptionalThe page number to retrieve from the list of collaborators.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/list-collaborators'.
#

GithubApi.ListProvisionedGroupsForEnterprise

Retrieve provisioned SCIM groups for an enterprise. This tool retrieves a list of provisioned SCIM groups within an enterprise account on GitHub. It is useful for administrators who need to manage or audit group provisions. For optimized performance, exclude 'members' from the response using the 'excludedAttributes' query parameter.

Parameters

ParameterTypeReq.Description
exclude_attribute_from_resultsstringOptionalSpecify an attribute to exclude from the results to speed up response time.
filter_by_attributestringOptionalFilter results by a specific attribute. Supported filters: `externalId`, `id`, `displayName`. Example: `externalId eq '9138790-10932-109120392-12321'`.
results_per_pageintegerOptionalThe number of SCIM group results to return per page for pagination.
start_indexintegerOptionalThe starting index for pagination; specifies where to begin returning results.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/list-provisioned-groups-enterprise'.
#

GithubApi.ListPublicGithubRepositories

Retrieve all public GitHub repositories. This tool lists all public repositories on GitHub, ordered by creation date. It uses pagination via the 'since' parameter and provides the Link header for navigating pages.

Parameters

ParameterTypeReq.Description
repository_visibilitystringOptionalSpecify types of repositories to return, such as 'all' or 'public'.
starting_repository_idintegerOptionalSpecify a repository ID to list only repositories with an ID greater than this value for pagination.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-public'.
#

GithubApi.ListPublicOrgEvents

List public events for a GitHub organization. This tool retrieves and lists all public events for a specified organization on GitHub. It is useful for monitoring recent activities within an organization.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
results_page_numberintegerOptionalPage number of the results to fetch. Determines which set of results to return.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/list-public-org-events'.
#

GithubApi.ListPublicOrgMembers

Retrieve public members of a GitHub organization. Use this tool to obtain a list of members who have publicized their membership in a specified GitHub organization.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
results_page_numberintegerOptionalThe page number of the results to fetch, used for pagination.
results_per_pageintegerOptionalSpecify the number of results to return per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/list-public-members'.
#

GithubApi.ListPublicOrgsForUser

Retrieve public organization memberships for a GitHub user. Use this tool to obtain a list of public organization memberships for a specified GitHub user. It does not require authentication and only retrieves public memberships. For private memberships, use an authenticated method.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user account handle to retrieve public organization memberships for.
results_page_numberintegerOptionalSpecify the page number of the results to fetch, for paginated results.
results_per_pageintegerOptionalThe number of results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/list-for-user'.
#

GithubApi.ListPublicSshKeys

Retrieve public SSH keys for the authenticated GitHub user. Call this tool to get a list of public SSH keys associated with the authenticated user's GitHub account. Requires authentication with `read:public_key` scope.

Parameters

ParameterTypeReq.Description
result_page_numberintegerOptionalSpecifies which page of results to fetch, starting from 1.
results_per_pageintegerOptionalThe number of SSH key results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/list-public-ssh-keys-for-authenticated-user'.
#

GithubApi.ListPullRequestCommentReactions

Retrieve reactions for a pull request review comment. Use this tool to list all reactions associated with a specific pull request review comment in a GitHub repository. It helps in understanding community engagement on specific comments.

Parameters

ParameterTypeReq.Description
comment_unique_identifierintegerRequiredThe unique identifier for the pull request review comment.
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
filter_reaction_typestringOptionalSpecify a single reaction type to filter results. Leave blank to return all reactions.
results_page_numberintegerOptionalSpecify the page number of results to fetch for reactions to a pull request review comment.
results_per_pageintegerOptionalSpecify the number of reactions to return per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/list-for-pull-request-review-comment'.
#

GithubApi.ListPullRequestCommits

Retrieve up to 250 commits for a specific pull request. Use this tool to get a list of commits associated with a particular pull request. This is useful when you want to review changes or keep track of modifications made in a pull request. For a complete list with more than 250 commits, consider using the List commits endpoint.

Parameters

ParameterTypeReq.Description
pull_request_numberintegerRequiredThe unique number identifying the pull request within the repository.
repository_namestringRequiredThe name of the repository. It is not case sensitive and should be given as a string.
repository_ownerstringRequiredThe account owner of the repository, not case sensitive.
results_page_numberintegerOptionalSpecify the page number of commit results to fetch. Useful for paginating through commit lists.
results_per_pageintegerOptionalSpecify the number of commit results to return per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/list-commits'.
#

GithubApi.ListPullRequestReviewComments

Retrieve all review comments for a pull request. This tool fetches all review comments associated with a specified pull request in a GitHub repository. It returns the comments sorted in ascending order by ID.

Parameters

ParameterTypeReq.Description
pull_request_numberintegerRequiredThe unique number identifying the pull request within the repository.
repository_namestringRequiredThe name of the GitHub repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
notifications_since_timestampstringOptionalFilter review comments updated after this timestamp in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.
page_number_to_fetchintegerOptionalThe specific results page number to retrieve.
results_per_pageintegerOptionalSpecify the number of results to return per page, with a maximum limit of 100.
sort_directionstringOptionalSpecifies the direction to sort results. Use 'asc' for ascending or 'desc' for descending. Ignored without the 'sort' parameter.
sort_results_bystringOptionalProperty to sort comments: 'created' or 'updated'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/list-review-comments'.
#

GithubApi.ListPullRequests

Retrieve pull requests from a GitHub repository. This tool retrieves a list of pull requests from a specified GitHub repository, including both open and draft requests, for users with appropriate GitHub plans.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository from which to retrieve pull requests. This name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
base_branch_namestringOptionalSpecify the base branch name to filter pull requests. Example: 'gh-pages'.
filter_by_headstringOptionalFilter pull requests by head user/organization and branch in `user:ref-name` format.
filter_by_statestringOptionalFilter pull requests by state: `open`, `closed`, or `all`.
page_numberintegerOptionalPage number of the results to fetch from the list of pull requests.
results_per_pageintegerOptionalThe number of pull requests to retrieve per page, with a maximum of 100 results allowed.
sort_directionstringOptionalThe direction of the sorting for pull requests. Use 'asc' for ascending or 'desc' for descending order. Defaults to 'desc' when 'sort' is 'created' or not specified.
sort_pull_request_results_bystringOptionalSpecify the criterion for sorting pull request results. Options are 'created', 'updated', 'popularity', or 'long-running'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/list'.
#

GithubApi.ListPullRequestsForCommit

Retrieve pull requests linked to a specific commit. Fetches pull requests associated with a specific commit in a GitHub repository. Returns merged pull requests if the commit is in the default branch; otherwise, only open pull requests are returned.

Parameters

ParameterTypeReq.Description
commit_shastringRequiredThe SHA identifier of the commit to fetch associated pull requests.
repository_namestringRequiredThe name of the repository (not case sensitive).
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
results_page_numberintegerOptionalPage number of the results to fetch from the list of pull requests associated with the commit.
results_per_pageintegerOptionalNumber of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-pull-requests-associated-with-commit'.
#

GithubApi.ListRecentCodeScanningAnalyses

Retrieve recent code scanning analyses for a repository. Use this tool to list the details of recent code scanning analyses for a GitHub repository. It retrieves a paginated list starting with the most recent analyses. Useful for understanding security events and code quality checks. Requires proper access tokens or GitHub App permissions for private repositories.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive, and it should match the GitHub account owning the target repository.
code_scanning_tool_guidstringOptionalThe GUID of the code scanning tool to filter results. Specify either this or 'tool_name', not both.
code_scanning_tool_namestringOptionalSpecify the name of a code scanning tool to list results by this tool only. Cannot be used with `tool_guid`.
filter_by_sarif_idstringOptionalFilter analyses that belong to a specific SARIF upload by providing the SARIF ID.
git_reference_for_analysesstringOptionalThe Git reference for analyses; format as `refs/heads/<branch>` for branches or `refs/pull/<number>/merge` for pull requests.
page_numberintegerOptionalThe page number of the results to fetch. Used for paginating through the list of analyses.
results_per_pageintegerOptionalNumber of results per page, with a maximum limit of 100.
sort_by_propertystringOptionalSpecify the property for sorting the results. Available option: 'created'.
sort_directionstringOptionalThe order to sort results, either ascending ('asc') or descending ('desc').

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'code-scanning/list-recent-analyses'.
#

GithubApi.ListRecentGithubEvents

Retrieve recent public events from GitHub. Obtain the most recent public events from GitHub, with events delayed by at least five minutes.

Parameters

ParameterTypeReq.Description
page_numberintegerOptionalThe page number of the GitHub public event results to fetch.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/list-public-events'.
#

GithubApi.ListRecentGithubMigrations

Retrieve the latest GitHub migrations for an organization. Use this tool to list recent migrations for a specified GitHub organization, including export and import activities. The list includes `repositories` only for export migrations.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name. This value is not case sensitive. Use to specify which organization's migrations to list.
exclude_attributesarray<string>OptionalA list of attributes to exclude from the API response to enhance performance.
results_page_numberintegerOptionalPage number to fetch specific results from the list of migrations.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum value of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'migrations/list-for-org'.
#

GithubApi.ListRecentPublicGists

Retrieve the most recently updated public gists. Call this tool to get a list of public gists on GitHub sorted by the most recent updates. Useful for accessing the latest shared code snippets or projects made publicly available on GitHub.

Parameters

ParameterTypeReq.Description
result_page_numberintegerOptionalPage number to fetch the results from. Use for pagination.
results_per_pageintegerOptionalSpecifies the number of gists to display per page. Maximum allowed is 100.
updated_sincestringOptionalA timestamp in ISO 8601 format to filter gists updated after this time.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/list-public'.
#

GithubApi.ListRepoCacheStatus

Lists the status of each repository cache replica. Use this tool to get information about the status of cache replicas for a specific GitHub repository. Ideal for monitoring or troubleshooting cache issues.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. It is not case sensitive and should clearly identify the GitHub repository of interest.
repository_ownerstringRequiredThe GitHub username of the repository owner. This is not case sensitive.
result_page_numberintegerOptionalThe page number of results to fetch, used for pagination.
results_per_pageintegerOptionalThe number of results per page (maximum 100).

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-cache-info'.
#

GithubApi.ListRepoCommitComments

Retrieve commit comments for a GitHub repository. This tool retrieves commit comments for a specified GitHub repository. It's useful when you want to analyze or display comments made on commits in a project. Call this tool when you need to access the comments sorted by ascending ID.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This name is not case sensitive.
results_page_numberintegerOptionalSpecify the page number of commit comments to fetch from the repository.
results_per_pageintegerOptionalNumber of commit comments to retrieve per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-commit-comments-for-repo'.
#

GithubApi.ListRepoInvitations

List open invitations for a GitHub repository. Use this tool to retrieve all currently open invitations for a specified GitHub repository, requiring admin rights for access.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. It's not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. The name is not case sensitive.
results_page_numberintegerOptionalSpecifies the page number to fetch results from, used for pagination.
results_per_pageintegerOptionalThe number of invitations to display per page, with a maximum limit of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-invitations'.
#

GithubApi.ListRepoLanguages

List programming languages used in a GitHub repository. This tool retrieves the languages used in a specified GitHub repository, along with the number of bytes of code written in each language. It should be called when you need to find out which programming languages are utilized in a repository on GitHub.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. Case insensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. Case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-languages'.
#

GithubApi.ListRepoNetworkPublicEvents

Retrieve public events for a network of repositories. Use this tool to get the latest public events associated with a network of repositories on GitHub. It is useful for monitoring activity across multiple related repositories.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This value is not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. This value is not case sensitive.
results_page_numberintegerOptionalSpecify the page number of results to retrieve. Use this to navigate through paginated results.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/list-public-events-for-repo-network'.
#

GithubApi.ListRepoPreReceiveHooks

List pre-receive hooks for a GitHub repository. Fetch all enabled, testing, and allowed disabled pre-receive hooks for a specific GitHub repository. This includes hooks that can be enabled at the repository level, excluding those disabled at higher levels and not configurable.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository, not case sensitive.
result_page_numberintegerOptionalThe number of the results page to fetch, starting from 1.
results_per_pageintegerOptionalThe number of results to display per page, maximum 100.
sort_directionstringOptionalSpecify 'asc' for ascending or 'desc' for descending sorting of results.
sort_hooks_bystringOptionalSpecifies the attribute to sort the pre-receive hooks by. Possible values are 'created', 'updated', or 'name'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/list-pre-receive-hooks-for-repo'.
#

GithubApi.ListRepoRequiredWorkflows

Retrieve required workflows in a GitHub repository. Use this tool to list required workflows in a GitHub repository. This is accessible to anyone with read access. For private repositories, an access token with the `repo` scope is necessary. GitHub Apps need `actions:read` permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. It is not case sensitive.
repository_namestringRequiredThe name of the GitHub repository you want to query. This is not case sensitive.
page_numberintegerOptionalThe specific page of workflow results to retrieve. Use this for pagination.
results_per_pageintegerOptionalSpecify the number of results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-repo-required-workflows'.
#

GithubApi.ListRepoSecrets

Retrieve all repository secrets without values. This tool retrieves all the secrets available in a specified GitHub repository without revealing their encrypted values. Authentication is required using an access token with `repo` scope. GitHub Apps need `secrets` repository permission to access this endpoint.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. It is not case sensitive.
results_page_numberintegerOptionalSpecifies the page number of the secrets list to fetch.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-repo-secrets'.
#

GithubApi.ListReposForOrgMigration

List all repositories for an organization's migration. Use this tool to retrieve a list of all repositories associated with a specific organization migration on GitHub. It's useful for tracking migration progress or fetching details about repositories being moved.

Parameters

ParameterTypeReq.Description
migration_unique_identifierintegerRequiredThe unique identifier for the organization migration in GitHub.
organization_namestringRequiredThe name of the organization. This name is not case sensitive and identifies the GitHub organization for which the migration repositories will be listed.
results_page_numberintegerOptionalPage number of the results to fetch, used for pagination.
results_per_pageintegerOptionalNumber of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'migrations/list-repos-for-org'.
#

GithubApi.ListRepositoryEnvironments

Retrieve environments for a GitHub repository. Use this tool to list all environments associated with a specific GitHub repository. It requires read access to the repository. If the repository is private, ensure to use an access token with the necessary `repo` scope. This endpoint is also accessible to GitHub Apps with `actions:read` permission.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository to retrieve environments for. This name is not case-sensitive.
repository_ownerstringRequiredThe GitHub username of the repository owner. Case insensitive.
results_page_numberintegerOptionalThe number of the page to retrieve for paginated results.
results_per_pageintegerOptionalThe number of results to retrieve per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-all-environments'.
#

GithubApi.ListRepositoryLabels

Retrieve labels for a GitHub repository. Use this tool to obtain the list of labels associated with a specified repository on GitHub. It helps in identifying the categories or tags used for organizing issues within the repository.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository, not case-sensitive.
repository_ownerstringRequiredThe GitHub username of the repository owner. It is not case sensitive.
result_page_numberintegerOptionalThe specific page number of results to fetch. Use this to navigate through paginated results.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/list-labels-for-repo'.
#

GithubApi.ListRepositoryProjects

Retrieve projects from a specific GitHub repository. Use this tool to list all the projects of a specified GitHub repository. It should be called when you need to view available projects. Note that a 404 status is returned if projects are disabled, and a 401 or 410 status if there are insufficient privileges.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. This value is not case sensitive.
project_statestringOptionalSpecify which state of projects to return: 'open', 'closed', or 'all'.
results_page_numberintegerOptionalSpecifies which page of the results to fetch. Useful for paginated responses.
results_per_pageintegerOptionalThe number of results to return per page. Maximum is 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/list-for-repo'.
#

GithubApi.ListRepositoryTeams

Retrieve a list of teams for a specified GitHub repository. Use this tool to get all the teams associated with a specific GitHub repository by providing the repository owner and name.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. Not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is case-insensitive.
result_page_numberintegerOptionalThe page number to fetch from the results. Use this to iterate through paginated data.
results_per_pageintegerOptionalThe number of results to include per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-teams'.
#

GithubApi.ListRepositoryWebhooks

Retrieve webhooks for a specified GitHub repository. Use this tool to list all webhooks configured for a specific GitHub repository. Helpful for managing and reviewing webhook configurations.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This value is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository, not case sensitive.
result_page_numberintegerOptionalThe page number of webhooks results to fetch from the repository.
results_per_pageintegerOptionalSpecify the number of webhooks to list per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-webhooks'.
#

GithubApi.ListRepoStargazers

Retrieve users who starred a specific GitHub repository. This tool provides a list of users that have starred a specified GitHub repository, along with the timestamps of when the stars were added. It's useful for understanding the popularity and engagement of a repository.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is case-insensitive.
repository_ownerstringRequiredThe username of the repository's account owner. The name is not case sensitive.
results_page_numberintegerOptionalSpecify the page number for results pagination to retrieve a specific set of stargazers.
results_per_pageintegerOptionalThe number of stargazer results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/list-stargazers-for-repo'.
#

GithubApi.ListReposWithOrgSecret

Retrieve repositories with access to a specific organization secret. This tool lists all repositories that have been given access to a specific organization secret with `selected` visibility. It requires authentication with an access token featuring the `admin:org` scope, or a GitHub App with `secrets` organization permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. It is not case sensitive.
secret_namestringRequiredThe name of the secret for which to list selected repositories. Case insensitive.
result_page_numberintegerOptionalPage number of the results to fetch for pagination.
results_per_pageintegerOptionalThe number of repositories to return per page, with a maximum of 100 allowed.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-selected-repos-for-org-secret'.
#

GithubApi.ListReposWithOrgVariableAccess

Retrieve repos accessing an organization's variable. This tool lists all repositories that have access to a specified organization variable. Authentication with an access token having the `admin:org` scope is required. GitHub Apps must have the `organization_actions_variables:read` permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. It is not case sensitive.
variable_namestringRequiredThe name of the organization variable to check for repository access.
result_page_numberintegerOptionalThe page number of repository results to retrieve. Use this to navigate through results.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-selected-repos-for-org-variable'.
#

GithubApi.ListReposWithRunnerGroupAccess

Retrieve repositories with access to a runner group in an organization. This tool lists the repositories that have access to a specified self-hosted runner group in an organization. It requires authentication with an access token having `admin:org` scope.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe case-insensitive name of the organization.
runner_group_idintegerRequiredUnique identifier of the self-hosted runner group to fetch repository access details.
result_page_numberintegerOptionalPage number of the results to fetch.
results_per_pageintegerOptionalThe number of results to retrieve per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-repo-access-to-self-hosted-runner-group-in-org'.
#

GithubApi.ListRequiredWorkflowRepositories

List repositories configured for a required workflow. This tool retrieves a list of repositories that are configured to use a specific required workflow within an organization. It should be called when you need to know which repositories are set up to run a required workflow. Authentication with an access token having `read:org` scope or a GitHub App with `administration` permission is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. It is not case sensitive and identifies the organization within GitHub.
workflow_unique_identifierintegerRequiredThe unique identifier of the required workflow for which the repositories are to be listed.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-selected-repositories-required-workflow'.
#

GithubApi.ListRequiredWorkflowRuns

Retrieve all workflow runs for a required workflow. Use this tool to list all workflow runs associated with a specific required workflow in a GitHub repository. It is useful for monitoring and analyzing the execution of required workflows. Requires repository read access, and for private repositories, an access token with the `repo` scope is needed.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. Case sensitivity is ignored.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
required_workflow_idintegerRequiredThe ID of the required workflow that has run at least once in a repository.
branch_namestringOptionalSpecify the branch name to filter workflow runs associated with it. Use the name of the branch from the `push`.
check_suite_identifierintegerOptionalSpecify the Check Suite ID to filter workflow runs associated with this specific ID.
exclude_pull_requestsbooleanOptionalIf true, pull requests are omitted from the response.
results_page_numberintegerOptionalThe page number of the results to fetch, used for pagination of the workflow runs.
results_per_pageintegerOptionalThe number of workflow run results to display per page, with a maximum limit of 100.
sha_for_head_commitstringOptionalReturns workflow runs associated with the specified head SHA (commit identifier).
trigger_eventstringOptionalSpecify the event type that triggers the workflow run, such as `push`, `pull_request`, or `issue`.
workflow_actor_usernamestringOptionalSpecify the username of the actor whose workflow runs you want to retrieve. Use the GitHub login for the user who initiated the push.
workflow_run_statusstringOptionalSpecify the workflow run status or conclusion to filter results. Options include 'completed', 'in_progress', 'success', etc.
workflow_runs_created_date_rangestringOptionalSpecify the date-time range to filter workflow runs based on their creation date. Use GitHub's date search syntax for formatting.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-required-workflow-runs'.
#

GithubApi.ListRequiredWorkflows

Retrieve all required workflows in a GitHub organization. Use this tool to get a list of all workflows that are required within a specific GitHub organization. Authentication with an access token having the `read:org` scope is necessary.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name. Note: The name is not case sensitive. This identifies which organization's workflows to list.
results_page_numberintegerOptionalThe specific page number of required workflow results to fetch.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-required-workflows'.
#

GithubApi.ListReviewCommentsForRepo

Retrieve review comments for all pull requests in a repository. Use this tool to obtain a list of review comments for all pull requests within a specified repository. This is useful for tracking feedback and discussions associated with pull requests.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository to fetch review comments from. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive. Specify the username or organization name.
page_numberintegerOptionalSpecify the page number of the results to retrieve from the API. Used for pagination.
results_per_pageintegerOptionalThe number of review comments to retrieve per page, with a maximum limit of 100.
sort_directionstringOptionalSpecifies the order to sort the review comments. Options are 'asc' for ascending and 'desc' for descending. Note: This is ignored if no 'sort' parameter is set.
sort_reviewsstringOptionalDetermines the order of review comments based on 'created', 'updated', or 'created_at'.
updated_afterstringOptionalTimestamp to filter notifications updated after this time in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/list-review-comments-for-repo'.
#

GithubApi.ListRunnerAppsForRepo

Retrieve runner application binaries for a GitHub repository. Use this tool to list binaries for GitHub runner applications that can be downloaded and run. Requires authentication with a token that has 'repo' scope.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. Case insensitive.
repository_ownerstringRequiredThe account owner of the repository on GitHub. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-runner-applications-for-repo'.
#

GithubApi.ListRunnerBinariesForEnterprise

Retrieve download links for runner application binaries. Use this tool to list available binaries for GitHub runner applications that can be downloaded and run for a specified enterprise. Authentication with an access token having the `manage_runners:enterprise` scope is required.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID for the enterprise to obtain runner binaries.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/list-runner-applications-for-enterprise'.
#

GithubApi.ListRunnerGroupsForOrg

Retrieve self-hosted runner groups for a GitHub organization. This tool lists all self-hosted runner groups configured in a specified GitHub organization, including those inherited from an enterprise. Authentication with an access token having the `admin:org` scope is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization's name. This is not case sensitive.
repository_visibility_filterstringOptionalSpecify the repository to filter runner groups that they are allowed to be used by.
results_page_numberintegerOptionalSpecify the page number of the results to fetch. Use an integer value.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-self-hosted-runner-groups-for-org'.
#

GithubApi.ListRunnerLabels

Retrieve all labels for a self-hosted runner in a GitHub repo. Use this tool to get all labels for a specific self-hosted runner configured in a GitHub repository. Authentication with a token that has the `repo` scope is required.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This is not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. Case insensitive.
self_hosted_runner_idintegerRequiredThe unique integer identifier of the self-hosted runner in the repository.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-labels-for-self-hosted-runner-for-repo'.
#

GithubApi.ListRunnerLabelsForOrg

Retrieve labels for a self-hosted runner in an organization. This tool is used to list all labels for a specified self-hosted runner within an organization. Authentication with an access token having the `admin:org` scope is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. This parameter is not case sensitive.
runner_unique_idintegerRequiredThe unique identifier for the self-hosted runner. It must be an integer.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-labels-for-self-hosted-runner-for-org'.
#

GithubApi.ListScimEnterpriseMembers

Lists provisioned SCIM enterprise members for GitHub enterprises. This tool retrieves a list of provisioned SCIM enterprise members associated with a GitHub enterprise account. It is useful for managing enterprise users and understanding membership status. The tool allows you to exclude certain attributes to improve query performance.

Parameters

ParameterTypeReq.Description
exclude_attributesstringOptionalSpecify attributes to exclude from the results to improve query performance. Commonly used values are 'groups'.
filter_criteriastringOptionalFilter results by `userName`, `externalId`, `id`, or `displayName`. Only one filter is supported. E.g., "externalId eq '9138790-10932-109120392-12321'".
pagination_start_indexintegerOptionalThe starting index of the first result to return for paginated responses.
results_per_pageintegerOptionalSpecify the number of SCIM enterprise members to return per page for pagination.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/list-provisioned-identities-enterprise'.
#

GithubApi.ListSecretScanningAlertLocations

Retrieve locations for a secret scanning alert in a repository. This tool retrieves all locations associated with a specific secret scanning alert within an eligible GitHub repository. It requires administrator access and a personal access token with appropriate scopes. Suitable for checking where a secret may have been exposed in repository files or areas.

Parameters

ParameterTypeReq.Description
alert_numberintegerRequiredThe unique identifier number for a secret scanning alert. This can be found at the end of the URL for a code scanning alert on GitHub, or in the `number` field of the response from the `GET /repos/{owner}/{repo}/code-scanning/alerts` API call.
repository_namestringRequiredThe name of the repository, case insensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. It is not case sensitive.
results_page_numberintegerOptionalThe page number of the results to fetch for the secret scanning alert locations.
results_per_pageintegerOptionalSpecify the number of results to return per page (maximum 100).

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'secret-scanning/list-locations-for-alert'.
#

GithubApi.ListSecretScanningAlertsForEnterprise

Retrieve secret scanning alerts for enterprise repositories. This tool fetches secret scanning alerts for eligible repositories within an enterprise, presented from newest to oldest. Users must be members of the enterprise and possess the appropriate access token with `repo` or `security_events` scope. Alerts are only available for organizations where the user has ownership or security management permissions.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID of the enterprise. This identifies the specific enterprise to list alerts for.
alert_resolution_filtersstringOptionalComma-separated list of alert resolutions to filter by: false_positive, wont_fix, revoked, pattern_edited, pattern_deleted, used_in_tests.
alert_state_filterstringOptionalSpecify if only 'open' or 'resolved' secret scanning alerts should be listed.
cursor_afterstringOptionalA cursor for retrieving results after this point, as specified in the Link header.
cursor_beforestringOptionalA cursor to fetch results before this point, as specified by the link header.
results_per_pageintegerOptionalThe number of results per page. Maximum is 100.
secret_types_to_returnstringOptionalA comma-separated list of secret types to return. By default, all secret types are returned. Refer to GitHub's secret scanning patterns documentation for supported types.
sort_bystringOptionalSpecify 'created' to sort by alert creation date or 'updated' to sort by the last update or resolution date.
sort_directionstringOptionalSpecify the direction ('asc' or 'desc') to sort the secret scanning alerts results.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'secret-scanning/list-alerts-for-enterprise'.
#

GithubApi.ListSecurityManagerTeams

Retrieve teams that are security managers in an organization. This tool retrieves a list of teams designated as security managers for a specified organization on GitHub. It should be used when you need to identify teams responsible for security within an organization. Requires appropriate access rights, like being an administrator or security manager with a token having the `read:org` scope.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization's name. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/list-security-manager-teams'.
#

GithubApi.ListSelectedRepositoriesForSecret

Retrieve repositories with selected access for an org secret. This tool lists all repositories that have been granted access to a secret in a GitHub organization, where the access visibility is set to 'selected'. Use it when you need to determine which repositories can access a particular secret. Requires an access token with 'admin:org' scope or 'dependabot_secrets' permission for GitHub Apps.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. This is not case sensitive. Required to identify the organization whose secret's repository access is being queried.
secret_namestringRequiredThe name of the secret for which you wish to list selected repositories. It is case insensitive.
results_page_numberintegerOptionalThe page number of the results to fetch, used for pagination.
results_per_pageintegerOptionalNumber of results per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/list-selected-repos-for-org-secret'.
#

GithubApi.ListSelfHostedRunnerGroups

Retrieve all self-hosted runner groups for an enterprise. Fetches a list of all self-hosted runner groups for a specified enterprise. Requires authentication with an access token having the 'manage_runners:enterprise' scope.

Parameters

ParameterTypeReq.Description
enterprise_slugstringRequiredThe slug or ID of the enterprise for which to list self-hosted runner groups. This identifies the enterprise by name or numeric ID.
organization_filterstringOptionalFilter results to show runner groups usable by the specified organization.
results_page_numberintegerOptionalSpecifies which page of the self-hosted runner groups results to retrieve. Useful for paginating through large sets of data.
results_per_pageintegerOptionalThe maximum number of results to return per page, up to 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/list-self-hosted-runner-groups-for-enterprise'.
#

GithubApi.ListSelfHostedRunners

Retrieve self-hosted runners for a GitHub repository. Use this tool to list all self-hosted runners configured in a specific GitHub repository. Authentication with an access token having the `repo` scope is required.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository (case-insensitive) for which to list self-hosted runners.
repository_ownerstringRequiredThe account owner of the repository, not case sensitive.
results_page_numberintegerOptionalPage number of the results to fetch for listing self-hosted runners.
results_per_pageintegerOptionalThe number of results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-self-hosted-runners-for-repo'.
#

GithubApi.ListSelfHostedRunnersForEnterprise

Retrieve all self-hosted runners for a GitHub enterprise. Use this tool to obtain a list of all self-hosted runners configured for a specified GitHub enterprise. Authentication with an access token having the `manage_runners:enterprise` scope is required.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID of the enterprise for which to list self-hosted runners.
results_page_numberintegerOptionalSpecify the page number of the results to fetch for pagination purposes.
results_per_pageintegerOptionalThe number of results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/list-self-hosted-runners-for-enterprise'.
#

GithubApi.ListSelfHostedRunnersInGroup

Retrieve self-hosted runners in an enterprise group. Use this tool to list the self-hosted runners associated with a specific group in an enterprise on GitHub. Authentication with an access token that has the 'manage_runners:enterprise' scope is required.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID of the enterprise. Use the slug version of the enterprise name or substitute with the enterprise ID.
runner_group_idintegerRequiredThe unique identifier of the self-hosted runner group within the enterprise.
results_page_numberintegerOptionalPage number of the results to fetch.
results_per_pageintegerOptionalThe number of results to display per page (maximum 100).

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/list-self-hosted-runners-in-group-for-enterprise'.
#

GithubApi.ListSshSigningKeys

Retrieve SSH signing keys for the authenticated GitHub user. This tool lists the SSH signing keys associated with the authenticated GitHub user's account. It requires authentication via Basic Auth or OAuth with `read:ssh_signing_key` scope.

Parameters

ParameterTypeReq.Description
results_page_numberintegerOptionalPage number of the results to fetch. Use this to navigate through paginated results.
results_per_pageintegerOptionalThe number of SSH signing key results to display per page. The maximum allowed is 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/list-ssh-signing-keys-for-authenticated-user'.
#

GithubApi.ListSshSigningKeysForUser

Retrieve SSH signing keys for a specific GitHub user. Use this tool to obtain the SSH signing keys associated with a given GitHub username. This operation can be performed by anyone.

Parameters

ParameterTypeReq.Description
github_usernamestringRequiredThe GitHub username whose SSH signing keys you want to retrieve.
results_page_numberintegerOptionalPage number of the results to fetch when listing SSH signing keys.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/list-ssh-signing-keys-for-user'.
#

GithubApi.ListStarredGists

Retrieve the authenticated user's starred gists. Call this tool to get the authenticated user's starred gists on GitHub. Useful for accessing gists that the user has marked as starred.

Parameters

ParameterTypeReq.Description
results_page_numberintegerOptionalSpecifies which page of results to fetch for the user's starred gists.
results_per_pageintegerOptionalSpecify the number of results per page. Maximum allowed is 100.
updated_since_timestringOptionalOnly show gists updated after this time. Use ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/list-starred'.
#

GithubApi.ListStarredRepos

Retrieve repositories starred by a user on GitHub. Use this tool to get a list of repositories that a specified GitHub user has starred, including the option to find out when stars were created.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user's handle (username) to retrieve starred repositories for.
page_numberintegerOptionalThe page number of the results to fetch, useful for pagination.
results_per_pageintegerOptionalThe number of repository results to return per page, with a maximum of 100.
sort_directionstringOptionalSpecify the direction to sort the results: 'asc' for ascending or 'desc' for descending.
sort_repositories_bystringOptionalProperty to sort the repositories by: 'created' for star date or 'updated' for last push date.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/list-repos-starred-by-user'.
#

GithubApi.ListStarredRepositories

Retrieve repositories starred by the authenticated user. This tool fetches a list of repositories that the authenticated user has starred on GitHub. It can also provide information on when the stars were created if desired.

Parameters

ParameterTypeReq.Description
page_number_to_fetchintegerOptionalSpecify the page number of results to retrieve. Use for pagination of starred repositories.
results_per_pageintegerOptionalThe number of repositories to return per page, maximum of 100.
sort_bystringOptionalThe property to sort the results by. Use 'created' for sorting by the star creation date or 'updated' for the last push date.
sort_directionstringOptionalThe direction to sort the results by. Use 'asc' for ascending or 'desc' for descending.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/list-repos-starred-by-authenticated-user'.
#

GithubApi.ListTeamDiscussionCommentReactions

Retrieve reactions for a team discussion comment in an organization. This tool retrieves the list of reactions for a specific comment in a team discussion within an organization on GitHub. It requires OAuth access tokens with the `read:discussion` scope. Use this when you need to analyze or display reactions to a particular discussion comment.

Parameters

ParameterTypeReq.Description
comment_identifierintegerRequiredThe unique number identifying the discussion comment.
discussion_numberintegerRequiredThe number identifying the specific discussion in the team.
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
team_slugstringRequiredThe slug of the team name, case-insensitive, used to identify the team in the organization.
filter_by_reaction_typestringOptionalSpecify a single reaction type to filter results. Options: '+1', '-1', 'laugh', 'confused', 'heart', 'hooray', 'rocket', 'eyes'. Omit to list all reactions.
results_page_numberintegerOptionalThe page number of the comments reactions to fetch from the results.
results_per_pageintegerOptionalThe number of results per page to return (maximum 100).

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'reactions/list-for-team-discussion-comment-in-org'.
#

GithubApi.ListTeamDiscussionComments

Retrieve comments from a team discussion in an organization. This tool lists all comments on a specified team discussion within an organization on GitHub. It requires an OAuth token with the `read:discussion` scope and can be used when you need to see all comments made in a particular team discussion.

Parameters

ParameterTypeReq.Description
discussion_idintegerRequiredThe unique number identifying the discussion to retrieve comments from.
organization_namestringRequiredThe name of the organization. It is not case sensitive.
team_slugstringRequiredThe identifier for the team, typically a URL-friendly version of the team name.
results_page_numberintegerOptionalThe specific page of discussion comments to retrieve, starting with 1 for the first page.
results_per_pageintegerOptionalThe number of discussion comments to return per page, maximum of 100.
sort_directionstringOptionalSpecify the sort order for results: 'asc' for ascending or 'desc' for descending.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/list-discussion-comments-in-org'.
#

GithubApi.ListTeamDiscussions

Retrieve all discussions from a team's page in an organization. Use this tool to get a list of discussions on a specified team's page within a GitHub organization. Requires OAuth access tokens with the `read:discussion` scope.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe case-insensitive name of the GitHub organization.
team_slugstringRequiredThe slug of the team's name to identify which team's discussions to retrieve in the organization.
pinned_discussions_onlystringOptionalFilter to retrieve only pinned discussions. Use 'true' for pinned only, 'false' for all.
results_page_numberintegerOptionalThe specific page number of discussion results to retrieve.
results_per_pageintegerOptionalThe number of results per page, with a maximum of 100.
sort_directionstringOptionalSpecify the sorting direction for the results. Use 'asc' for ascending or 'desc' for descending order.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/list-discussions-in-org'.
#

GithubApi.ListTeamMembersInOrg

Retrieve team members in a specified organization. Call this tool to get a list of members in a specific team within an organization on GitHub. It includes members from child teams, provided that the authenticated user has visibility of the team.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
team_slugstringRequiredThe slug of the team name within the organization. Used to identify the specific team.
filter_by_rolestringOptionalFilters team members by their role: 'member', 'maintainer', or 'all'.
result_page_numberintegerOptionalThe page number of results to fetch. Use this for pagination.
results_per_pageintegerOptionalSpecifies the number of team members to return per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/list-members-in-org'.
#

GithubApi.ListTeamProjectsInOrg

Retrieve a list of projects for a team in an organization. Use this tool to get a list of organization projects associated with a specific team based on the organization name and team slug. Ideal for fetching project details for managerial or planning purposes.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe case-insensitive name of the organization for which to list team projects.
team_slugstringRequiredThe team's unique slug identifier. This is used to specify which team's projects to list.
results_page_numberintegerOptionalThe page number for the results you wish to retrieve. Used for paginating through results.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum limit of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/list-projects-in-org'.
#

GithubApi.ListTeamRepositories

Retrieve a list of repositories for a specified team. This tool lists repositories associated with a specified team within an organization, visible to the authenticated user. Ideal for obtaining an overview of team-managed projects.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe organization name. Case insensitivity applies.
team_slugstringRequiredThe slug of the team name (case-insensitive).
results_page_numberintegerOptionalThe page number of the results to fetch for pagination.
results_per_pageintegerOptionalNumber of results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/list-repos-in-org'.
#

GithubApi.ListUserAccessibleRepos

List repositories accessible to the authenticated user. Retrieve a list of repositories that the authenticated user can access with specific permissions for a GitHub app installation. Useful for determining the user's access level to various repositories.

Parameters

ParameterTypeReq.Description
installation_identifierintegerRequiredThe unique identifier for the GitHub app installation required to list the repositories.
results_page_numberintegerOptionalSpecify the page number of results to fetch, starting from 1.
results_per_pageintegerOptionalSpecify the number of repository results to return per page (maximum 100).

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/list-installation-repos-for-authenticated-user'.
#

GithubApi.ListUserEmailAddresses

Retrieve all email addresses of the authenticated user. Fetches all email addresses associated with the authenticated GitHub user, indicating which are public. Useful for managing email visibility or account settings. Requires `user:email` scope.

Parameters

ParameterTypeReq.Description
results_page_numberintegerOptionalSpecify the page number to fetch results for user email addresses.
results_per_pageintegerOptionalThe number of email results to retrieve per page, maximum is 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/list-emails-for-authenticated-user'.
#

GithubApi.ListUserFollowers

Retrieve a list of followers for a specific GitHub user. Use this tool to get the list of people following a specified GitHub user. It should be called when you need information about who is following a particular user.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user handle to list followers for.
results_page_numberintegerOptionalSpecify the page number of results to retrieve followers for the specified user. Use this to paginate through results if there are many followers.
results_per_pageintegerOptionalThe number of follower results to display per page, with a maximum limit of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/list-followers-for-user'.
#

GithubApi.ListUserGists

Lists a user's gists or public gists if unauthenticated. This tool retrieves the list of gists for the authenticated user. If no authentication is provided, it returns all public gists. Useful for gathering a user's code snippets or public contributions.

Parameters

ParameterTypeReq.Description
page_number_to_fetchintegerOptionalSpecify the page number of the results to fetch.
results_per_pageintegerOptionalSpecify the number of gists to return per page. Maximum is 100.
show_gists_sincestringOptionalShow gists updated after the specified time in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/list'.
#

GithubApi.ListUserGithubEvents

Retrieve a user's GitHub events, including private if authenticated. This tool retrieves GitHub events for a specified user. If authenticated, it includes private events; otherwise, only public events are shown.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub username for which to retrieve events. Use the handle of the user account.
page_numberintegerOptionalThe page number of results to fetch for the user's GitHub events.
results_per_pageintegerOptionalNumber of results to return per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/list-events-for-authenticated-user'.
#

GithubApi.ListUserGithubTeams

Retrieve teams the authenticated GitHub user belongs to. This tool lists all teams across organizations that the authenticated user is a part of on GitHub. Requires appropriate OAuth scope.

Parameters

ParameterTypeReq.Description
results_page_numberintegerOptionalPage number to specify which set of results to fetch. Useful for pagination.
results_per_pageintegerOptionalNumber of results to display per page, maximum value is 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/list-for-authenticated-user'.
#

GithubApi.ListUserGpgKeys

Retrieve authenticated user's GPG keys from GitHub. Use this tool to obtain a list of the authenticated user's GPG keys on GitHub. Authentication via Basic Auth or OAuth with 'read:gpg_key' scope is required. This tool is useful for managing or verifying keys associated with a GitHub account.

Parameters

ParameterTypeReq.Description
page_numberintegerOptionalSpecifies which page of results to retrieve for the GPG keys list. Use integers starting from 1.
results_per_pageintegerOptionalSpecify the number of results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/list-gpg-keys-for-authenticated-user'.
#

GithubApi.ListUserIssues

Fetch issues and pull requests assigned to you. Lists issues and pull requests across owned and member repositories assigned to the authenticated GitHub user. Useful for tracking tasks assigned to you. Includes both issues and pull requests, distinguishable by the `pull_request` key.

Parameters

ParameterTypeReq.Description
issue_filter_typestringOptionalSpecifies the type of issues to return. Options: 'assigned', 'created', 'mentioned', 'subscribed', 'all'.
issue_statestringOptionalSpecifies whether to return open, closed, or all issues.
label_filterstringOptionalComma-separated list of label names to filter issues by. Example: 'bug,ui,@high'.
result_page_numberintegerOptionalSpecifies the page number of the results to fetch. Use for paginating through result sets.
results_per_pageintegerOptionalSpecify the number of issues or pull requests to return per page. The maximum allowed value is 100.
sort_bystringOptionalChoose sorting method for results: 'created', 'updated', or 'comments'.
sort_directionstringOptionalSpecifies the sorting direction of the results, either ascending (`asc`) or descending (`desc`).
updated_sincestringOptionalShow issues updated after this timestamp. Use ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/list-for-authenticated-user'.
#

GithubApi.ListUserMigrationRepos

Retrieve repositories for a user's migration. This tool lists all the repositories associated with a user's migration on GitHub. Use it when you need to access the repositories involved in a specific migration.

Parameters

ParameterTypeReq.Description
migration_unique_identifierintegerRequiredThe unique identifier for the user migration to retrieve repositories.
result_page_numberintegerOptionalSpecify the page number of results to retrieve. Use this to paginate through multiple pages of repository data.
results_per_pageintegerOptionalThe number of repository results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'migrations/list-repos-for-authenticated-user'.
#

GithubApi.ListUserMigrations

Lists all migrations a user has started. Use this tool to retrieve a list of all the migrations initiated by an authenticated user on GitHub.

Parameters

ParameterTypeReq.Description
results_page_numberintegerOptionalThe specific page of migration results to retrieve, starting from 1.
results_per_pageintegerOptionalThe number of migration results per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'migrations/list-for-authenticated-user'.
#

GithubApi.ListUserNotifications

Retrieve notifications for the authenticated GitHub user. This tool retrieves all notifications for the authenticated GitHub user, sorted by most recently updated. It should be called when the user wants to check their latest notifications.

Parameters

ParameterTypeReq.Description
filter_notifications_before_datestringOptionalOnly show notifications updated before the specified ISO 8601 timestamp (`YYYY-MM-DDTHH:MM:SSZ`).
include_read_notificationsbooleanOptionalSet to `true` to include notifications marked as read in the results.
notifications_since_timestampstringOptionalReturn notifications updated after this timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
only_show_participating_notificationsbooleanOptionalIf true, only shows notifications where the user is directly participating or mentioned.
results_page_numberintegerOptionalSpecify the page number of the notification results to fetch.
results_per_pageintegerOptionalThe number of notifications to display per page, with a maximum limit of 50.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/list-notifications-for-authenticated-user'.
#

GithubApi.ListUserOrganizations

List organizations for the authenticated GitHub user. This tool retrieves a list of organizations that the authenticated user can interact with on GitHub. It requires OAuth scope such as `user` or `read:org` to access this information. Use this tool to find out which organizations a user is part of and can manage.

Parameters

ParameterTypeReq.Description
page_number_to_fetchintegerOptionalPage number of the results to fetch for user organizations.
results_per_pageintegerOptionalThe number of organizations listed per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/list-for-authenticated-user'.
#

GithubApi.ListUserProjects

Retrieve a list of GitHub projects for a specific user. Call this tool to get the projects associated with a specified GitHub username.

Parameters

ParameterTypeReq.Description
github_usernamestringRequiredThe GitHub username of the account whose projects are to be listed.
project_statestringOptionalSpecify the state of projects to return. Options are 'open', 'closed', or 'all'.
results_page_numberintegerOptionalSpecify the page number of the results to fetch when listing user projects.
results_per_pageintegerOptionalThe number of projects to display per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/list-for-user'.
#

GithubApi.ListUserReceivedPublicEvents

Retrieve public events received by a GitHub user. This tool fetches a list of public events received by a specified GitHub user. It should be called when there is a need to understand the public activities involving the user.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub handle for the user account whose public events are to be listed.
page_numberintegerOptionalSpecify the page number of the results you wish to fetch.
results_per_pageintegerOptionalThe number of results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/list-received-public-events-for-user'.
#

GithubApi.ListUserRepositories

Retrieve repositories accessible to the authenticated user. This tool lists repositories that the authenticated user can access with explicit permissions like `:read`, `:write`, or `:admin`. It includes repositories owned by the user, those where they are collaborators, and those accessible through organization membership.

Parameters

ParameterTypeReq.Description
filter_repositories_before_timestampstringOptionalOnly show repositories updated before the specified timestamp in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.
repository_affiliation_filterstringOptionalSpecify affiliations for repositories to list. Options: `owner`, `collaborator`, `organization_member`. Provide as a comma-separated string.
repository_typestringOptionalLimit results to repositories of the specified type: 'all', 'owner', 'public', 'private', or 'member'. Avoid using with 'visibility' or 'affiliation'.
repository_visibilitystringOptionalLimit results to repositories with the specified visibility: 'all', 'public', or 'private'.
results_page_numberintegerOptionalSpecify the page number of the results to fetch.
results_per_pageintegerOptionalThe maximum number of repositories to display per page. Accepts an integer up to 100.
sort_orderstringOptionalSpecify the order to sort repositories. Use 'asc' for ascending or 'desc' for descending. Default is 'asc' for 'full_name' sort and 'desc' otherwise.
sort_propertystringOptionalProperty by which to sort repositories, such as `created`, `updated`, `pushed`, or `full_name`.
updated_after_timestampstringOptionalFilter repositories updated after the specified ISO 8601 timestamp (YYYY-MM-DDTHH:MM:SSZ).

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/list-for-authenticated-user'.
#

GithubApi.ListUsersWithBranchAccess

Retrieve users with push access to a protected branch on GitHub. This tool should be called to obtain a list of users who have push access to a specific protected branch in a GitHub repository. It is applicable to both public and private repositories under various GitHub plans, including Free, Pro, Team, and Enterprise. Use this when you need to manage or review user permissions for branch access.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe exact name of the branch to check for push access. Wildcard characters are not allowed.
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/get-users-with-access-to-protected-branch'.
#

GithubApi.ListWatchedRepos

Retrieve a list of repositories a user watches on GitHub. Use this tool to obtain the repositories that a specified GitHub user is watching.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub handle of the user whose watched repositories are to be retrieved.
results_page_numberintegerOptionalPage number of the results to fetch for the user's watched repositories.
results_per_pageintegerOptionalSpecify the number of repository results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/list-repos-watched-by-user'.
#

GithubApi.ListWatchedRepositories

Retrieve repositories watched by the authenticated user. Use this tool to obtain a list of repositories that the authenticated GitHub user is currently watching. It's useful for managing or displaying watched repositories.

Parameters

ParameterTypeReq.Description
results_page_numberintegerOptionalSpecify the page number of the results to fetch. Used for pagination of results.
results_per_pageintegerOptionalThe number of repository results displayed per page (maximum 100).

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/list-watched-repos-for-authenticated-user'.
#

GithubApi.ListWatchersForRepo

Retrieve the list of users watching a GitHub repository. Use this tool to get a list of all users who are watching a specific GitHub repository. It provides the necessary information about the watchers for a given repository by its owner and repo name.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository to list watchers for. It is not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. It's case insensitive.
results_page_numberintegerOptionalPage number of the results to fetch. Helps in paginating through results.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/list-watchers-for-repo'.
#

GithubApi.ListWebhookDeliveries

Retrieve webhook deliveries for a GitHub App. Use this tool to obtain a list of webhook deliveries associated with a GitHub App. Authentication requires a JWT.

Parameters

ParameterTypeReq.Description
only_redeliveriesbooleanOptionalSet to true to include only redeliveries in the results.
pagination_cursorstringOptionalStarting point for pagination to fetch a page of deliveries. Use the `link` header to find next and previous page cursors.
results_per_pageintegerOptionalThe number of webhook deliveries to return per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/list-webhook-deliveries'.
#

GithubApi.ListWorkflowArtifacts

Retrieve artifacts from a GitHub workflow run. Use this tool to list artifacts associated with a specific GitHub workflow run. It requires read access to the repository and appropriate permissions if the repository is private.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
workflow_run_idintegerRequiredThe unique identifier of the specific workflow run to retrieve artifacts from.
page_number_to_fetchintegerOptionalThe page number of the artifacts results to retrieve.
results_per_pageintegerOptionalNumber of results to return per page, up to a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-workflow-run-artifacts'.
#

GithubApi.ListWorkflowRunJobs

Retrieve jobs from a specific GitHub workflow run attempt. This tool retrieves jobs for a specific workflow run attempt on GitHub. It is useful for users who need to monitor or analyze job details of a workflow run. Access to the repository is required, and permissions depend on whether the repository is public or private.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository to fetch jobs from. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository, not case sensitive.
workflow_run_attempt_numberintegerRequiredThe attempt number of the specific workflow run to retrieve jobs for. This is typically used to distinguish between multiple attempts of the same run.
workflow_run_idintegerRequiredThe unique identifier of the workflow run to list jobs for.
results_page_numberintegerOptionalSpecify the page number of the results to fetch, used for pagination.
results_per_pageintegerOptionalSpecifies the number of job results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/list-jobs-for-workflow-run-attempt'.
#

GithubApi.LockGithubIssue

Lock a GitHub issue or pull request conversation. Use this tool to prevent further interactions with a specific GitHub issue or pull request by locking its conversation. It requires push access to the repository.

Parameters

ParameterTypeReq.Description
issue_numberintegerRequiredThe number that identifies the GitHub issue to lock.
repository_namestringRequiredThe name of the repository in which the issue or pull request exists. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This name is not case sensitive.
issue_lock_reasonstringOptionalThe reason for locking the conversation. Acceptable values: 'off-topic', 'too heated', 'resolved', 'spam'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/lock'.
#

GithubApi.ManageEnterpriseSecurityFeature

Enable or disable a security feature for an enterprise. Use this tool to enable or disable a specified security feature across all repositories within an enterprise. Requires administrative access and an access token with the `admin:enterprise` scope.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug version of the enterprise name or the enterprise ID.
security_featurestringRequiredSpecify the security feature to enable or disable. Options: 'advanced_security', 'secret_scanning', 'secret_scanning_push_protection'.
set_enablement_statusstringRequiredSpecify 'enable_all' to activate or 'disable_all' to deactivate the security feature for all repositories in the enterprise.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'secret-scanning/post-security-product-enablement-for-enterprise'.
#

GithubApi.ManageGithubEnvironmentSecret

Create or update an encrypted environment secret on GitHub. This tool allows you to create or update an environment secret in a GitHub repository. It requires encryption of the secret value using LibSodium and authentication with a token that has the 'repo' scope. Ideal for automating secret management in deployment environments.

Parameters

ParameterTypeReq.Description
encrypted_secret_valuestringRequiredThe secret value encrypted with LibSodium using a public key. Retrieve the key from the 'Get an environment public key' endpoint.
encryption_key_idstringRequiredThe identifier for the encryption key used to encrypt the secret. This is required to ensure the correct decryption of the secret on GitHub.
environment_namestringRequiredThe name of the environment in the GitHub repository where the secret will be created or updated.
repository_unique_idintegerRequiredThe unique identifier of the GitHub repository where the secret will be managed.
secret_namestringRequiredThe name of the secret to be created or updated in the GitHub environment.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/create-or-update-environment-secret'.
#

GithubApi.ManageGithubRepoSecret

Create or update an encrypted GitHub repository secret. Use this tool to create or update an encrypted secret for a GitHub repository. Authentication requires a token with the `repo` scope or `dependabot_secrets` permission. The secret must be encrypted using LibSodium.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive. Specify the GitHub username or organization name.
secret_namestringRequiredThe name of the repository secret to create or update. Case insensitive.
encrypted_secret_valuestringOptionalThe secret's value encrypted using LibSodium and a public key from the repository's public key endpoint.
encryption_key_idstringOptionalThe ID of the key used to encrypt the secret. This key is retrieved from GitHub's repository public key endpoint.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/create-or-update-repo-secret'.
#

GithubApi.ManageGithubThreadNotifications

Manage GitHub notifications for specific threads. Use this tool to ignore future notifications for GitHub threads, or to subscribe to threads you aren't receiving notifications for. Ideal for managing notifications on watched repositories by ignoring or subscribing to specific threads.

Parameters

ParameterTypeReq.Description
notification_thread_idintegerRequiredThe unique ID of the notification thread, as retrieved from the GitHub notifications API.
ignore_thread_notificationsbooleanOptionalSet to true to block all notifications from a thread. Use false to allow notifications.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/set-thread-subscription'.
#

GithubApi.ManageOrgSecurityFeatures

Toggle security features for all repositories in an organization. This tool is used to enable or disable a specified security feature across all repositories in a GitHub organization. It requires organization owner access or a security manager role, and a token with 'write:org' scope. GitHub Apps must have the 'organization_administration:write' permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. This value is not case sensitive.
security_featurestringRequiredSpecifies the security feature to enable or disable. Options include: dependency_graph, dependabot_alerts, dependabot_security_updates, advanced_security, secret_scanning, secret_scanning_push_protection.
security_feature_actionstringRequiredSpecifies whether to enable or disable the security feature for all organization repositories. Use 'enable_all' to activate and 'disable_all' to deactivate.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/enable-or-disable-security-product-on-all-org-repos'.
#

GithubApi.MarkGithubNotificationsAsRead

Mark all GitHub notifications as read for the current user. Use this tool to mark all notifications as 'read' in GitHub for the authenticated user. If there are too many notifications, the process may run asynchronously, and any remaining 'unread' notifications can be checked using a separate endpoint.

Parameters

ParameterTypeReq.Description
mark_notifications_as_readbooleanOptionalA boolean flag to set notifications as read. True marks notifications as read.
notifications_last_read_timestampstringOptionalA timestamp marking the last time notifications were checked. Notifications updated since this time won't be marked as read. Use ISO 8601 format `YYYY-MM-DDTHH:MM:SSZ`. Leave empty to mark all as read.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/mark-notifications-as-read'.
#

GithubApi.MarkGithubThreadAsRead

Mark a GitHub thread notification as read. Use this tool to mark a GitHub notification thread as read. It mirrors the action of clicking a notification in the GitHub notification inbox.

Parameters

ParameterTypeReq.Description
notification_thread_idintegerRequiredThe unique identifier for the GitHub notification thread to be marked as read. Obtain this from the `id` field when retrieving notifications.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/mark-thread-as-read'.
#

GithubApi.MarkRepoNotificationsAsRead

Mark all repository notifications as read for the user. Use this tool to mark all notifications in a specified repository as read for the authenticated user. If there are too many notifications, the process may be completed asynchronously.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
last_checked_timestampstringOptionalTimestamp for last notification check in ISO 8601 format. Omitting marks all as read. Defaults to current time if omitted.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/mark-repo-notifications-as-read'.
#

GithubApi.MergeGithubBranch

Merge a branch into a GitHub repository. Use this tool when you need to merge one branch into another in a GitHub repository. It facilitates branch management by integrating changes from different branches.

Parameters

ParameterTypeReq.Description
base_branch_namestringRequiredThe name of the base branch that the head will be merged into. This is the branch you want to merge changes into.
head_branch_or_commit_shastringRequiredThe branch name or commit SHA1 to be merged into the base branch.
repository_namestringRequiredThe name of the GitHub repository, not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
merge_commit_messagestringOptionalCustom commit message for the merge. Defaults to a standard message if not provided.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/merge'.
#

GithubApi.MergeGithubPullRequest

Merge a pull request on GitHub. This tool merges a specified pull request on GitHub for a given repository. It should be called when a user wants to merge changes from a pull request into the main branch. Notifications will be triggered, and users should be mindful of secondary rate limits.

Parameters

ParameterTypeReq.Description
pull_request_numberintegerRequiredThe unique number identifying the pull request to be merged.
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
commit_titlestringOptionalTitle for the automatic commit message after merging the pull request.
extra_commit_messagestringOptionalExtra detail to append to the automatic commit message for the pull request.
merge_methodstringOptionalSpecifies the method to merge the pull request. Options include 'merge', 'squash', or 'rebase'.
pull_request_head_shastringOptionalSHA of the pull request head that must match for the merge to proceed.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/merge'.
#

GithubApi.MoveGithubProjectColumn

Move a column within a GitHub project board. Use this tool to change the position of a project column in a GitHub project board to better organize tasks or workflow.

Parameters

ParameterTypeReq.Description
column_positionstringRequiredSpecifies where to move the project column. Use `first`, `last`, or `after:<column_id>` to position after a specific column.
project_column_idintegerRequiredThe unique identifier of the column to be moved in the GitHub project.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/move-column'.
#

GithubApi.MoveProjectCard

Move a project card to a different position. Use this tool to move a card in a GitHub project to a different position within a column. This is helpful when reorganizing tasks or priorities in project management.

Parameters

ParameterTypeReq.Description
card_identifierintegerRequiredThe unique identifier for the card to be moved within the project.
card_positionstringRequiredSpecify where to place the card within the column: 'top', 'bottom', or 'after:<card_id>'.
destination_column_idintegerOptionalThe unique identifier of the column to which the card should be moved.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/move-card'.
#

GithubApi.MuteGithubThreadNotifications

Mute all future notifications for a GitHub thread. Use this tool to mute notifications for a specific GitHub conversation thread. Notifications will be silenced until you comment on the thread or receive an @mention. This tool is helpful if you want to focus on relevant updates without distractions.

Parameters

ParameterTypeReq.Description
notification_thread_idintegerRequiredThe unique identifier for the specific GitHub notification thread to mute. Obtain from the `id` field of fetched notifications.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/delete-thread-subscription'.
#

GithubApi.OrganizationAppInstallations

Retrieve GitHub App installations for an organization. Use this tool to list all GitHub Apps installed within a specified organization. Requires organization owner status with `admin:read` scope.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
page_number_to_fetchintegerOptionalPage number of the results to fetch. Used for pagination in retrieving GitHub App installations.
results_per_pageintegerOptionalThe number of GitHub App installations to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/list-app-installations'.
#

GithubApi.PromoteUserToSiteAdmin

Promote a user to site administrator on GitHub Enterprise. Use this tool to elevate a user's role to site administrator within a GitHub Enterprise instance. Ensure the 'Content-Length' is set to zero when invoking this endpoint.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe handle for the GitHub user account to be promoted to site administrator.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/promote-user-to-be-site-administrator'.
#

GithubApi.ProvisionEnterpriseUser

Create a new SCIM enterprise user identity. This tool creates an external identity for a new SCIM enterprise user. It's used for provisioning users in enterprises using SCIM before they can sign in through SAML. When converting an existing enterprise to use SCIM, the SCIM `userName` is utilized to match new users to existing enterprise users. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/provision-enterprise-user'.
#

GithubApi.QueueLdapSyncForTeam

Queue an LDAP sync job for a specified team. This tool is used to queue an LDAP sync job for a specific GitHub team. It should be called when you want to sync LDAP mappings for a team. A successful response indicates the job has been queued, not that it has been completed.

Parameters

ParameterTypeReq.Description
team_idintegerRequiredThe unique identifier of the GitHub team for which the LDAP sync job should be queued.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/sync-ldap-mapping-for-team'.
#

GithubApi.RedeliverGithubWebhook

Redelivers a webhook delivery for a GitHub repository. Use this tool to redeliver a previously attempted webhook delivery for a specific webhook configured in a GitHub repository. It can be called when a webhook delivery has failed and needs to be retried.

Parameters

ParameterTypeReq.Description
hook_unique_identifierintegerRequiredThe unique identifier for the GitHub webhook hook. This ID is required to specify which webhook to redeliver.
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe repository's account owner. The name is not case sensitive.
webhook_delivery_idintegerRequiredThe unique identifier for the webhook delivery attempt to be redelivered.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/redeliver-webhook-delivery'.
#

GithubApi.RedeliverGithubWebhookDelivery

Redeliver a GitHub App webhook delivery. Use this tool to redeliver a webhook delivery for a GitHub App. Authentication with a JWT is required for access.

Parameters

ParameterTypeReq.Description
webhook_delivery_idintegerRequiredThe unique integer ID of the webhook delivery to be redelivered.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/redeliver-webhook-delivery'.
#

GithubApi.RedeliverWebhookDelivery

Redeliver an organization's webhook delivery attempt. Use this tool to redeliver a delivery for a webhook configured in an organization. It is useful when a webhook delivery initially failed or needs to be tested again.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. This is not case sensitive.
webhook_delivery_idintegerRequiredThe unique identifier of the webhook delivery to be redelivered.
webhook_hook_idintegerRequiredThe unique identifier of the webhook hook. Provide an integer value.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/redeliver-webhook-delivery'.
#

GithubApi.RemoveActionsCacheKey

Delete GitHub Actions caches by key for a repository. Use this tool to delete one or more GitHub Actions caches for a repository by specifying a complete cache key. Optionally, provide a Git ref to restrict deletions. Requires an access token with `repo` scope or `actions:write` permission for GitHub Apps.

Parameters

ParameterTypeReq.Description
cache_keystringRequiredThe key used to identify and delete a specific GitHub Actions cache.
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Not case sensitive.
git_reference_for_cache_deletionstringOptionalSpecify the Git reference to restrict cache deletion. Use `refs/heads/<branch>` for branches or `refs/pull/<number>/merge` for pull requests.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/delete-actions-cache-by-key'.
#

GithubApi.RemoveAllCustomLabelsRunnerOrg

Remove all custom labels from an organization's self-hosted runner. Use this tool to remove all custom labels from a specific self-hosted runner in a GitHub organization. Requires authentication with an access token having `admin:org` scope. Returns the runner's remaining read-only labels.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name, not case sensitive.
runner_idintegerRequiredThe unique identifier of the self-hosted runner. This is required to target the specific runner for label removal in an organization.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/remove-all-custom-labels-from-self-hosted-runner-for-org'.
#

GithubApi.RemoveAllLabelsFromGithubIssue

Remove all labels from a GitHub issue. Use this tool to remove all labels from a specific issue in a GitHub repository. It should be called when you need to clear labels from an issue efficiently.

Parameters

ParameterTypeReq.Description
github_issue_numberintegerRequiredThe identifier number for the GitHub issue from which all labels should be removed.
repository_namestringRequiredThe name of the repository. It is not case sensitive and must be provided as a string.
repository_ownerstringRequiredThe GitHub account owner of the repository, case-insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/remove-all-labels'.
#

GithubApi.RemoveAuthorizedSshKey

Remove an authorized SSH key from GitHub Enterprise. Use this tool to remove an authorized SSH key from the GitHub Enterprise server. Useful for revoking access when a key is compromised or no longer needed.

Parameters

ParameterTypeReq.Description
public_ssh_keystringRequiredThe public SSH key to be removed from GitHub Enterprise.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/remove-authorized-ssh-key'.
#

GithubApi.RemoveBranchAccessRestriction

Remove access restrictions from a GitHub branch. This tool is used to remove restrictions on who can push to a protected branch in a GitHub repository. It's applicable for both public and private repositories under various GitHub plans. Call this tool when you need to allow all collaborators to push to a specific branch.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe name of the branch to remove access restrictions from. Cannot contain wildcard characters.
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. The value is not case-sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete-access-restrictions'.
#

GithubApi.RemoveBranchStatusCheckContexts

Remove status check contexts from a protected branch. Use this tool to delete status check contexts from a protected branch in a GitHub repository. This applies to various GitHub plans, allowing for flexible management of branch protections. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. Enter a GitHub username, which is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository, case insensitive, to target for status check context removal. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
branch_namestringOptionalThe name of the branch from which to remove status check contexts. Cannot contain wildcard characters. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/remove-status-check-contexts'.
#

GithubApi.RemoveCustomLabelFromRunner

Remove a custom label from a self-hosted runner in an enterprise. This tool removes a specified custom label from a self-hosted runner configured in an enterprise and returns the remaining labels. It should be called when you need to update runner labels, and requires authentication with an access token having 'manage_runners:enterprise' scope.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredSlug or ID of the enterprise. Use the slug version of the enterprise name or the enterprise ID as an alternative.
runner_custom_label_namestringRequiredThe name of the custom label to be removed from the self-hosted runner.
runner_identifierintegerRequiredUnique identifier for the self-hosted runner.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/remove-custom-label-from-self-hosted-runner-for-enterprise'.
#

GithubApi.RemoveCustomLabelsFromRunner

Remove all custom labels from an enterprise's self-hosted runner. This tool removes all custom labels from a self-hosted runner configured in an enterprise using GitHub's API. It is used when you need to reset or clear custom labels from a runner, and it returns the runner’s remaining read-only labels. Authentication with a token that has `manage_runners:enterprise` scope is required.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug version of the enterprise name or the enterprise ID for identifying the enterprise.
runner_idintegerRequiredThe unique identifier of the self-hosted runner from which to remove custom labels.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/remove-all-custom-labels-from-self-hosted-runner-for-enterprise'.
#

GithubApi.RemoveCustomLabelsRunnerRepo

Remove all custom labels from a self-hosted runner in a repository. This tool removes all custom labels from a specified self-hosted runner configured in a repository, returning the remaining read-only labels. Authentication using an access token with the `repo` scope is required.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. It is not case-sensitive.
repository_ownerstringRequiredThe account owner of the repository. Case insensitive.
runner_unique_identifierintegerRequiredUnique identifier of the self-hosted runner to remove custom labels from.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/remove-all-custom-labels-from-self-hosted-runner-for-repo'.
#

GithubApi.RemoveEnterpriseAnnouncement

Removes the global announcement banner in your enterprise. This tool removes the global announcement banner in a GitHub enterprise setup. Use it to clear announcements when they are no longer needed.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/remove-announcement'.
#

GithubApi.RemoveGithubAppBranchAccess

Remove an app's access to a protected GitHub branch. Use this tool to remove the ability of a GitHub app to push to a protected branch. Applicable for branches in public and private repositories under various GitHub plans. Only apps with 'write' access to 'contents' permission can be removed. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_owner_accountstringOptionalThe account owner of the repository, case insensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the GitHub repository, not case-sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
branch_namestringOptionalThe name of the branch to remove app access from. Wildcards are not allowed. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/remove-app-access-restrictions'.
#

GithubApi.RemoveGithubAppSuspension

Unsuspend a GitHub App installation. This tool removes the suspension of a GitHub App installation. Use this when you need to reactivate an app on GitHub that has been suspended. Requires authentication with a JSON Web Token (JWT) as a GitHub App.

Parameters

ParameterTypeReq.Description
installation_idintegerRequiredThe unique identifier for the GitHub App installation to be unsuspended.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/unsuspend-installation'.
#

GithubApi.RemoveGithubOrgSecret

Delete a secret from a GitHub organization. Use this tool to delete a Dependabot secret from a specific GitHub organization by providing the secret name. Authentication with an access token with the `admin:org` scope is required. This tool is suitable when you need to manage organization secrets programmatically.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. This is not case sensitive.
secret_name_to_deletestringRequiredThe name of the secret to delete from the GitHub organization.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/delete-org-secret'.
#

GithubApi.RemoveGithubRepoSecret

Delete a secret from a GitHub repository. Use this tool to delete a specific secret from a GitHub repository's dependabot configuration. Requires authentication with an access token with the 'repo' scope, or GitHub Apps with 'dependabot_secrets' repository permission.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository, not case sensitive.
repository_ownerstringRequiredThe account owner of the repository, not case sensitive.
secret_namestringRequiredThe name of the secret to be deleted from the repository.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/delete-repo-secret'.
#

GithubApi.RemoveGithubSshKey

Removes a public SSH key from your GitHub account. Use this tool to remove a public SSH key from the authenticated user's GitHub account. Authentication must be done via Basic Auth or OAuth with the `admin:public_key` scope.

Parameters

ParameterTypeReq.Description
ssh_key_unique_identifierintegerRequiredThe unique identifier for the SSH key to be removed from the GitHub account.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/delete-public-ssh-key-for-authenticated-user'.
#

GithubApi.RemoveGpgKey

Remove a GPG key from your GitHub account. Use this tool to delete a GPG key associated with your authenticated GitHub account. Ensure you have the required authentication with `admin:gpg_key` scope.

Parameters

ParameterTypeReq.Description
gpg_key_identifierintegerRequiredThe unique identifier of the GPG key to be removed from the authenticated user's account.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/delete-gpg-key-for-authenticated-user'.
#

GithubApi.RemoveIssueAssignees

Remove assignees from a GitHub issue. This tool removes one or more assignees from a specified issue in a GitHub repository. Use it when you need to update issue responsibilities and assign different collaborators.

Parameters

ParameterTypeReq.Description
issue_numberintegerRequiredThe unique number identifying the GitHub issue to modify.
repository_namestringRequiredThe name of the repository. This is case-insensitive and used to identify the specific repository affected.
repository_ownerstringRequiredThe account owner of the GitHub repository. This value is not case sensitive.
assignees_to_removearray<string>OptionalList of usernames to remove as assignees from the issue. Only users with push access will see changes.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/remove-assignees'.
#

GithubApi.RemoveIssueLabel

Remove a specified label from a GitHub issue. Use this tool to remove a specific label from a GitHub issue and retrieve the remaining labels on that issue. It returns an error if the label does not exist.

Parameters

ParameterTypeReq.Description
issue_numberintegerRequiredThe unique number identifying the issue in the repository.
label_namestringRequiredSpecifies the label to be removed from the GitHub issue. The label name is case-sensitive.
repository_namestringRequiredThe name of the repository where the issue resides. It is case-insensitive.
repository_ownerstringRequiredThe account owner of the repository. This value is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/remove-label'.
#

GithubApi.RemoveOrgAccessRunnerGroup

Removes an organization's access to a self-hosted runner group. Use this tool to remove an organization from accessing a specific self-hosted runner group in an enterprise. Requires authentication with a token having `manage_runners:enterprise` scope.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID of the enterprise to identify it for the runner group operation.
organization_idintegerRequiredThe unique identifier for the organization to be removed from the self-hosted runner group.
runner_group_idintegerRequiredUnique identifier of the self-hosted runner group to modify access for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/remove-org-access-to-self-hosted-runner-group-in-enterprise'.
#

GithubApi.RemoveOrganizationMember

Remove a user from an organization's access list. Use this tool to remove a user from all teams in a GitHub organization, revoking their access to the organization's repositories. Call this when you need to manage access permissions for organization members.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user's handle to be removed from the organization.
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/remove-member'.
#

GithubApi.RemoveOrgAnnouncementBanner

Remove the announcement banner for a GitHub organization. Use this tool to delete the announcement banner that is currently set for a specific GitHub organization. Ideal for managing organizational announcements.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization's name. This is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'announcement-banners/remove-announcement-banner-for-org'.
#

GithubApi.RemoveOrgMember

Remove a user's membership from a GitHub organization. Invoke this tool to remove a user from an organization's membership on GitHub. If the user is a member, they'll be removed; if invited, the invitation will be canceled. The user will be notified via email.

Parameters

ParameterTypeReq.Description
github_usernamestringRequiredThe GitHub username to remove from the organization; it is not case-sensitive.
organization_namestringRequiredThe case-insensitive name of the GitHub organization.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/remove-membership-for-user'.
#

GithubApi.RemoveOrgOutsideCollaborator

Remove a user from all organization repositories. Use this tool to remove a user from all repositories in a specified organization by removing them from the outside collaborators list.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user account handle to remove from the organization's repositories.
organization_namestringRequiredThe name of the organization from which to remove the user. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/remove-outside-collaborator'.
#

GithubApi.RemoveOrgPreReceiveHook

Removes pre-receive hook enforcement overrides for an organization. Use this tool to remove any pre-receive hook enforcement overrides at the organization level. This action is applicable when you need to revert to the default hook settings set at a higher level than the organization.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization where the pre-receive hook enforcement override will be removed. It is not case sensitive.
pre_receive_hook_idintegerRequiredThe unique identifier for the pre-receive hook to be removed.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/remove-pre-receive-hook-enforcement-for-org'.
#

GithubApi.RemoveProjectCollaborator

Remove a collaborator from a GitHub organization project. Call this tool to remove a collaborator from a specified GitHub organization project. The user must be an organization owner or a project admin to perform this operation.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user's handle to be removed as a collaborator.
project_unique_identifierintegerRequiredThe unique numeric identifier of the GitHub organization project.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/remove-collaborator'.
#

GithubApi.RemoveProjectFromTeam

Remove a project from a team in a GitHub organization. Use this tool to remove an organization project from a specific team within GitHub. It requires appropriate permissions: `read` access to both the team and project, or `admin` access to either. The operation only removes the project from the team and does not delete the project itself.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. This value is not case sensitive.
project_unique_identifierintegerRequiredThe unique identifier of the project to be removed from the team.
team_slugstringRequiredThe slug identifier for the team name in the organization. Case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/remove-project-in-org'.
#

GithubApi.RemovePublicOrgMembership

Remove public organization membership for the user. This tool removes the public membership of the authenticated user from a specified GitHub organization. Call this tool when a user wants to revoke their public membership from an organization.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user account handle for which to remove public organization membership.
organization_namestringRequiredThe name of the GitHub organization. This name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/remove-public-membership-for-authenticated-user'.
#

GithubApi.RemovePullRequestReviewers

Remove requested reviewers from a GitHub pull request. Use this tool to remove specific requested reviewers from a pull request on GitHub. This is helpful when you need to update the list of reviewers on an active pull request.

Parameters

ParameterTypeReq.Description
pull_request_numberintegerRequiredThe unique identifier number for the pull request you want to modify.
repository_namestringRequiredThe name of the repository from which to remove reviewers. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is case-insensitive.
user_logins_to_removearray<string>RequiredAn array of user logins to be removed from the pull request as reviewers.
team_slugs_to_removearray<string>OptionalAn array of team slugs that should be removed as reviewers from the pull request. Each slug corresponds to a team associated with the repository.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/remove-requested-reviewers'.
#

GithubApi.RemovePullRequestReviewProtection

Remove pull request review protection from a branch. Use this tool to remove the requirement for pull request reviews on a protected branch in a GitHub repository. This is useful for adjusting branch protection rules in repositories. Applies to various GitHub plans as outlined in GitHub documentation.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe specific name of the branch to remove pull request review protection from. Wildcard characters are not allowed.
repository_namestringRequiredThe case-insensitive name of the repository from which to remove pull request review protection.
repository_ownerstringRequiredThe account owner of the repository. It's not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/delete-pull-request-review-protection'.
#

GithubApi.RemoveRepoAccessFromRunnerGroup

Remove repository access from a self-hosted runner group. Use this tool to remove a repository's access from a specified self-hosted runner group within an organization. The runner group must have its visibility set to 'selected'. Authentication with an 'admin:org' scope access token is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. This input is not case sensitive.
repository_unique_idintegerRequiredThe unique identifier of the repository to remove access from the runner group. Must be an integer.
runner_group_unique_idintegerRequiredUnique identifier of the self-hosted runner group. This is required to specify which runner group's access will be modified.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/remove-repo-access-to-self-hosted-runner-group-in-org'.
#

GithubApi.RemoveRepoCollaborator

Remove a collaborator from a GitHub repository. Use this tool to remove a specified user as a collaborator from a GitHub repository. Call this when you need to revoke someone's access to a repository.

Parameters

ParameterTypeReq.Description
collaborator_usernamestringRequiredThe GitHub user handle for the collaborator to be removed.
repository_namestringRequiredThe name of the GitHub repository, case insensitive.
repository_owner_namestringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/remove-collaborator'.
#

GithubApi.RemoveRepoFromInstallation

Remove a repository from a GitHub app installation. This tool removes a single repository from a GitHub app installation. The user must have admin access and be authenticated via a personal access token.

Parameters

ParameterTypeReq.Description
installation_unique_identifierintegerRequiredThe unique identifier for the installation, needed to specify which installation to modify.
repository_idintegerRequiredThe unique integer identifier of the repository to be removed from the installation.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/remove-repo-from-installation-for-authenticated-user'.
#

GithubApi.RemoveRepoFromOrgSecret

Remove a repository from an organization's secret access. Use this tool to remove a specified repository from accessing an organization's secret when the visibility is set to 'selected'. Authentication with an access token with 'admin:org' scope is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe organization name. It is not case sensitive.
repository_idintegerRequiredThe unique ID of the repository to be removed from the organization's secret.
secret_namestringRequiredThe name of the organization secret to remove the repository from.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/remove-selected-repo-from-org-secret'.
#

GithubApi.RemoveRepoFromOrgVariable

Remove a repository from a GitHub organization variable. This tool removes a specified repository from an organization's variable that is available to selected repositories. Useful when managing organization-level variable access. Requires authentication with an admin token or necessary permissions for GitHub Apps.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. This is not case sensitive.
repository_idintegerRequiredThe ID of the repository to be removed from the organization variable. This should be an integer value identifying the repository.
variable_namestringRequiredThe name of the organization variable to remove the repository from.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/remove-selected-repo-from-org-variable'.
#

GithubApi.RemoveRepoFromRequiredWorkflow

Removes a repository from a GitHub required workflow. Use this tool to remove a repository from a GitHub required workflow. Ensure the workflow is set for selected repositories and authenticate with an 'admin:org' scoped token.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. This is not case sensitive.
repository_identifierintegerRequiredThe unique identifier of the repository to be removed from the required workflow.
required_workflow_identifierintegerRequiredThe unique identifier of the required workflow to be removed.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/remove-selected-repo-from-required-workflow'.
#

GithubApi.RemoveRepoFromTeam

Remove a repository from a GitHub team within an organization. Call this tool to remove a repository from a specific team in a GitHub organization. The user needs to be an organization owner, team maintainer, or have admin access to the repository. This action will only unlink the repository from the team, not delete it.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case-sensitive.
repository_namestringRequiredThe name of the repository to remove from the team. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is not case sensitive.
team_slugstringRequiredThe slug of the team name to identify which team's repository link should be removed. This is required and case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/remove-repo-in-org'.
#

GithubApi.RemoveRepoHookEnforcement

Remove overridden pre-receive hook enforcement for a repository. This tool deletes any overridden pre-receive hook enforcement on a specified repository. It responds with the effective hook enforcement values inherited from the owner or global level. Use it when you need to revert to default hook settings.

Parameters

ParameterTypeReq.Description
pre_receive_hook_identifierintegerRequiredThe unique identifier of the pre-receive hook for the repository.
repository_namestringRequiredThe case-insensitive name of the repository from which to remove the hook enforcement.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/remove-pre-receive-hook-enforcement-for-repo'.
#

GithubApi.RemoveRunnerFromEnterpriseGroup

Remove a self-hosted runner from an enterprise group. This tool removes a self-hosted runner from a specified group in an enterprise and returns it to the default group. It requires authentication using an access token with the `manage_runners:enterprise` scope.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID of the enterprise. Use either the slug version of the enterprise name or the enterprise ID.
runner_group_idintegerRequiredUnique identifier of the self-hosted runner group to remove a runner from.
runner_identifierintegerRequiredThe unique integer identifier of the self-hosted runner to be removed from the enterprise group.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/remove-self-hosted-runner-from-group-for-enterprise'.
#

GithubApi.RemoveRunnerFromGroup

Remove a self-hosted runner from an organization's group. This tool removes a self-hosted runner from a specific group within an organization on GitHub. The runner is moved back to the default group. Requires authentication with an access token having `admin:org` scope.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. This value is not case sensitive.
runner_group_identifierintegerRequiredUnique identifier of the self-hosted runner group for removal action.
runner_idintegerRequiredUnique identifier of the self-hosted runner to remove from the group.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/remove-self-hosted-runner-from-group-for-org'.
#

GithubApi.RemoveRunnerLabel

Remove a custom label from a self-hosted runner in a repository. Use this tool to remove a custom label from a self-hosted runner configured in a GitHub repository. It returns the remaining labels for the runner. Ensure to authenticate with a token with `repo` scope. A `404 Not Found` status is returned if the label is not found.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This name is not case sensitive.
runner_custom_label_namestringRequiredThe name of the custom label on the self-hosted runner to be removed.
runner_unique_identifierintegerRequiredThe unique ID number of the self-hosted runner to identify which runner to remove the label from.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/remove-custom-label-from-self-hosted-runner-for-repo'.
#

GithubApi.RemoveSecurityManagerRole

Remove security manager role from a team in an organization. Use this tool to remove the security manager role from a specific team within an organization on GitHub. This requires the user to be an organization administrator with an access token having the 'admin:org' scope, or for GitHub Apps, the 'administration' organization read-write permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe organization's name. It is not case sensitive.
team_identifierstringRequiredThe unique slug identifying the team by name. This is required to specify the team whose security manager role is to be removed.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/remove-security-manager-team'.
#

GithubApi.RemoveSelfHostedRunner

Removes a self-hosted runner from a GitHub repository. Use this tool to forcibly remove a self-hosted runner from a GitHub repository when the machine no longer exists. Requires authentication with a token that has the `repo` scope.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
runner_unique_identifierintegerRequiredUnique identifier of the self-hosted runner to be removed.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/delete-self-hosted-runner-from-repo'.
#

GithubApi.RemoveSelfHostedRunnerFromEnterprise

Remove a self-hosted runner from an enterprise. Use this tool to forcefully remove a self-hosted runner from an enterprise when the machine no longer exists. Authentication with an access token having the `manage_runners:enterprise` scope is required.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID of the enterprise. Use the slug version of the name or the enterprise ID for identification.
runner_idintegerRequiredUnique identifier for the self-hosted runner to be removed.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/delete-self-hosted-runner-from-enterprise'.
#

GithubApi.RemoveSelfHostedRunnerFromOrg

Forcefully remove a self-hosted runner from an organization. Use this tool to completely remove a self-hosted GitHub Actions runner from an organization when the associated machine no longer exists. Requires an access token with the `admin:org` scope.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization's name. This input is not case sensitive.
runner_idintegerRequiredUnique identifier of the self-hosted GitHub runner to be removed.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/delete-self-hosted-runner-from-org'.
#

GithubApi.RemoveStatusCheckProtection

Remove status check protection from a GitHub branch. This tool removes the required status check protection from a specified branch in a GitHub repository. It should be called when you want to lift status check requirements from a protected branch.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe name of the branch from which you want to remove status check protection. Wildcard characters are not allowed. Use the GraphQL API for wildcard support.
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe GitHub username or organization name that owns the repository, case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/remove-status-check-protection'.
#

GithubApi.RemoveTeamAccessFromBranch

Remove a team's push access to a protected GitHub branch. This tool removes the ability of a specified team to push to a protected branch in a GitHub repository. It should be called when you need to revoke push access for a team, including child teams, on a specific branch. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository. This is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
branch_namestringOptionalThe exact name of the branch from which to remove team access. Wildcard characters are not allowed. For wildcard usage, employ the GraphQL API. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/remove-team-access-restrictions'.
#

GithubApi.RemoveTeamMembership

Remove a user's membership from a GitHub team. Use this tool to remove a user's membership from a specific GitHub team within an organization. Ensure the authenticated user has 'admin' permissions or is an owner of the organization. Note that team synchronization settings may affect API changes.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe handle for the GitHub user account to be removed from the team.
organization_namestringRequiredThe GitHub organization name. This input is not case sensitive.
team_slugstringRequiredThe slug identifier for the GitHub team's name. This is used to specify the team you want to modify.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/remove-membership-for-user-in-org'.
#

GithubApi.RemoveUserAccessFromBranch

Remove users' push access from a GitHub branch. This tool is used to remove the ability of specified users to push to a protected branch in a GitHub repository. It supports repositories with GitHub Free, Pro, Team, Enterprise Cloud, and Server plans. Use this tool to manage access restrictions on your protected branches. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. This value is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository. It is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
branch_namestringOptionalThe name of the branch to remove user access from. It must not contain wildcard characters. For using wildcards, refer to the GitHub GraphQL API. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/remove-user-access-restrictions'.
#

GithubApi.RenameGithubBranch

Rename a branch in a GitHub repository. Use this tool to rename a branch in a specific GitHub repository. Requires appropriate permissions based on whether the branch is default or not. Note that pushing to the old branch name is prohibited during the rename process.

Parameters

ParameterTypeReq.Description
current_branch_namestringRequiredThe current name of the branch to be renamed. Cannot include wildcard characters.
new_branch_namestringRequiredThe new name for the branch. Ensure it doesn’t contain wildcard characters.
repository_namestringRequiredThe name of the GitHub repository. It is case insensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository, not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/rename-branch'.
#

GithubApi.RenderMarkdown

Convert Markdown content to HTML rendering. Use this tool to convert Markdown text into HTML format, suitable for displaying on web pages or applications.

Parameters

ParameterTypeReq.Description
markdown_textstringRequiredThe Markdown text to convert into HTML format.
rendering_modestringOptionalSpecifies the rendering mode: 'markdown' for plain Markdown or 'gfm' for GitHub Flavored Markdown.
repository_contextstringOptionalThe repository context for linking references in `gfm` mode (e.g., 'octo-org/octo-repo').

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'markdown/render'.
#

GithubApi.RenderMarkdownPlain

Convert Markdown text to rendered plain text format. Use this tool to convert Markdown text to a plain-text format without GitHub Flavored Markdown support. Ideal for rendering Markdown as it appears in README.md files. The content size must be 400 KB or less.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'markdown/render-raw'.
#

GithubApi.RequestGithubPagesBuild

Request a build for your GitHub Pages site. Use this tool to manually trigger a GitHub Pages build from the latest revision on the default branch. This is useful for diagnosing build warnings and failures without making additional commits. Only one build can be in progress per repository at a time.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. Case-insensitive.
repository_owner_namestringRequiredThe GitHub account owner of the repository. Case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/request-pages-build'.
#

GithubApi.RequestGithubPullRequestReviewers

Request reviewers for a GitHub pull request. Use this tool to request specific reviewers for a pull request on GitHub. The tool triggers notifications to the selected reviewers. Beware of secondary rate limiting when calling this endpoint too frequently. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. It should be a case-insensitive string. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the GitHub repository. This input is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
pull_request_numberintegerOptionalThe number identifying the GitHub pull request for which reviewers will be requested. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/request-reviewers'.
#

GithubApi.RequireSignedCommitsOnBranch

Enable signed commit requirement on a GitHub branch. This tool requires signed commits on a specified branch of a GitHub repository. It is used when you have admin or owner permissions and have enabled branch protection on the target branch.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe name of the branch for which to require signed commits. It cannot contain wildcard characters. For using wildcards, refer to the GitHub GraphQL API.
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. Name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-commit-signature-protection'.
#

GithubApi.RerequestGithubCheckSuite

Rerequest a check suite on GitHub without code changes. Use this tool to trigger GitHub to rerequest an existing check suite, resetting its status to 'queued' and clearing its conclusion. This is useful for re-running checks without pushing new code. Ensure your GitHub App has the necessary permissions to perform this action.

Parameters

ParameterTypeReq.Description
check_suite_identifierintegerRequiredThe unique identifier of the GitHub check suite to be rerequested.
repository_namestringRequiredThe name of the repository. It is not case sensitive. Specify the repository whose check suite you want to rerequest.
repository_ownerstringRequiredThe account owner of the repository (case insensitive).

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'checks/rerequest-suite'.
#

GithubApi.RerunFailedGithubWorkflowJobs

Re-run failed jobs in a GitHub workflow run. This tool re-runs all failed jobs and their dependents in a specified GitHub workflow run. Use this when a workflow has failed jobs you want to attempt again. Authentication with a token having `repo` scope is required.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. This is not case sensitive.
workflow_run_idintegerRequiredThe unique identifier of the GitHub workflow run to re-run failed jobs for.
enable_debug_loggingbooleanOptionalEnable debug logging for the re-run of failed workflow jobs.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/re-run-workflow-failed-jobs'.
#

GithubApi.RerunGithubWorkflow

Initiates the rerun of a specific GitHub workflow. Use this tool to re-run a GitHub workflow run by providing its ID. Requires authentication with a token having 'repo' scope, or 'actions:write' permission for GitHub Apps.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. It is not case sensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. The name is not case sensitive.
workflow_run_idintegerRequiredThe unique identifier of the workflow run to be re-run.
enable_debug_loggingbooleanOptionalEnable debug logging for the workflow re-run by setting to true.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/re-run-workflow'.
#

GithubApi.ResetGithubOauthToken

Reset an OAuth token for a GitHub application. Use this tool to reset a valid OAuth token for a GitHub application using Basic Authentication with the application's client_id and client_secret. This operation invalidates the previous token immediately. A 404 error indicates the token was invalid.

Parameters

ParameterTypeReq.Description
github_app_client_idstringRequiredThe client ID of the GitHub application required for resetting the OAuth token.
oauth_access_tokenstringRequiredThe access token of the OAuth application to be reset.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/reset-token'.
#

GithubApi.RetrieveRunnerDetails

Retrieve information about a self-hosted runner in a GitHub repo.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This corresponds to the GitHub repository name and is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This name is not case sensitive.
runner_identifierintegerRequiredUnique identifier of the self-hosted runner. Required to fetch specific runner details.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/get-self-hosted-runner-for-repo'.
#

GithubApi.RevokeGithubInstallationToken

Revoke your GitHub installation access token. This tool revokes the GitHub installation token currently being used for authentication. Once revoked, the token becomes invalid and cannot be used for further authentication. This is useful when you need to invalidate an access token immediately.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/revoke-installation-access-token'.
#

GithubApi.RevokeGithubOauthGrant

Revoke OAuth grant for a GitHub application and user. This tool is used to revoke a grant for a specified user's OAuth application on GitHub. It requires Basic Authentication using the application's client_id and client_secret, along with the user's access_token. Once executed, it deletes all OAuth tokens for the user associated with the application, removing the application's access to the user's GitHub account.

Parameters

ParameterTypeReq.Description
github_app_client_idstringRequiredThe unique client ID for the GitHub app, used for Basic Authentication.
oauth_access_tokenstringRequiredThe OAuth access token for authenticating the GitHub API and revoking the grant.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/delete-authorization'.
#

GithubApi.RevokeGithubOauthToken

Revoke a GitHub OAuth application's token. Use this tool to revoke a single token for a GitHub OAuth application. Requires basic authentication with the application's client ID and client secret.

Parameters

ParameterTypeReq.Description
github_app_client_idstringRequiredThe client ID of the GitHub OAuth application to identify the app during token revocation.
oauth_access_tokenstringRequiredThe OAuth access token used to authenticate to the GitHub API. Required for token revocation.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/delete-token'.
#

GithubApi.SearchCodeInGithub

Search for code in GitHub repositories. Use this tool to search for specific terms within files in GitHub repositories. It supports queries by file content, language, and repository, returning highlighted matches when requested. Call this tool when you need to locate code definitions or usage across GitHub's repositories, limited to the default branch and files smaller than 384 KB.

Parameters

ParameterTypeReq.Description
search_querystringRequiredA string containing search keywords and qualifiers to limit the search scope on GitHub. For more details, see the GitHub search query documentation.
results_page_numberintegerOptionalThe page number of the results to fetch. Use this to navigate through search results.
results_per_pageintegerOptionalSpecifies the number of results to return per page, with a maximum of 100.
sort_by_recent_indexstringOptionalSort the search results by most recently indexed files. The only valid value is `indexed`.
sort_orderstringOptionalDetermines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). Ignored unless `sort` is provided.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'search/code'.
#

GithubApi.SearchGithubCommits

Search for GitHub commits using various criteria. Use this tool to find specific commits in a GitHub repository's default branch based on search criteria. It's useful for retrieving commits by keywords, repository, or other parameters. The tool returns commit information, including text match metadata for messages.

Parameters

ParameterTypeReq.Description
commit_search_querystringRequiredA string containing search keywords and qualifiers to find specific commits. Use qualifiers to narrow the search to specific areas of GitHub. See the API documentation for constructing queries with qualifiers.
result_orderstringOptionalDetermines whether the first search result returned has the highest number of matches ('desc') or the lowest ('asc'). Used only with 'sort'.
results_page_numberintegerOptionalPage number of the results to fetch. Determines which set of results to retrieve in paginated requests.
results_per_pageintegerOptionalThe number of results to display per page, with a maximum of 100.
sort_results_bystringOptionalSort results by `author-date` or `committer-date`. Defaults to best match if not specified.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'search/commits'.
#

GithubApi.SearchGithubIssuesAndPrs

Search GitHub issues and pull requests by state and keyword. Utilize this tool to find specific GitHub issues or pull requests using keywords and state filters. Ideal for investigating issues labeled as bugs, enhancing workflows by finding unresolved issues, or sorting issues by creation date. The tool supports searching using various qualifiers like language or labels, and can return up to 100 items per request. Note: To search both issues and pull requests, separate queries are required.

Parameters

ParameterTypeReq.Description
search_querystringRequiredA string containing search keywords and qualifiers to limit search to specific areas. Supports various qualifiers for refined search.
results_page_numberintegerOptionalSpecify the page number of results to fetch (starting from 1).
results_per_pageintegerOptionalThe number of results to return per page, with a maximum limit of 100.
sort_bystringOptionalSpecifies the sorting criteria for the results, such as by comments, reactions, or date created. Defaults to best match if not specified.
sort_orderstringOptionalDetermines whether the first search result returned is the highest number of matches (desc) or lowest number of matches (asc). This parameter is ignored unless you provide a sort value.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'search/issues-and-pull-requests'.
#

GithubApi.SearchGithubRepositories

Search GitHub repositories using various criteria. This tool finds GitHub repositories based on specific criteria such as keywords, language, and sort order. It can return up to 100 results per page and provides options for text match metadata to highlight search results in the name and description fields.

Parameters

ParameterTypeReq.Description
search_querystringRequiredA string containing search keywords and qualifiers to find specific repositories. Supports qualifiers and keywords for targeted searches. Refer to GitHub's documentation for query construction details: https://docs.github.com/enterprise-server@3.8/articles/searching-for-repositories/.
result_orderstringOptionalSet to 'desc' for highest matches first or 'asc' for lowest matches first in search results. Ignored if 'sort' is not provided.
results_page_numberintegerOptionalSpecify the page number of the results to fetch in the search query. Useful for navigating through paginated results.
results_per_pageintegerOptionalSpecify the number of repository results to return per page, with a maximum of 100.
sort_bystringOptionalSort results by `stars`, `forks`, `help-wanted-issues`, or `updated`. Default is best match.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'search/repos'.
#

GithubApi.SearchGithubTopics

Search and retrieve topics from GitHub using specific criteria. This tool allows you to search for GitHub topics using various criteria, providing results sorted by best match. It can return up to 100 results per page and supports text match metadata for enhanced search capabilities. Use it to find topics related to specific keywords or qualifiers.

Parameters

ParameterTypeReq.Description
search_querystringRequiredSearch query containing keywords and qualifiers to filter GitHub topics. Supports the same qualifiers as GitHub's web interface.
result_page_numberintegerOptionalThe page number to fetch in the search results. Maximum is 100 results per page.
results_per_pageintegerOptionalSpecify the number of search results to return per page, with a maximum of 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'search/topics'.
#

GithubApi.SendGithubHookPing

Triggers a ping event on a GitHub organization webhook. Use this tool to send a ping event to a specified webhook in a GitHub organization. This can be used to verify the connection or test the webhook's configuration.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
webhook_hook_idintegerRequiredThe unique integer ID of the GitHub organization webhook to ping.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/ping-webhook'.
#

GithubApi.SendPingEventToWebhook

Triggers a ping event to a GitHub webhook. Use this tool to trigger a ping event to be sent to a specified GitHub webhook. It is useful for testing and verifying webhook configurations.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. Case insensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. This name is not case-sensitive.
webhook_identifierintegerRequiredThe unique identifier of the GitHub webhook to send the ping event to. Must be an integer.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/ping-webhook'.
#

GithubApi.SetAdminBranchProtection

Set admin branch protection in a GitHub repository. Use this tool to enforce admin branch protection on a specified branch in a GitHub repository. Requires admin or owner permissions, and branch protection must be enabled.

Parameters

ParameterTypeReq.Description
branch_namestringRequiredThe exact name of the branch to set admin protection. Wildcards not supported.
repository_namestringRequiredThe case-insensitive name of the repository to set admin branch protection for.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/set-admin-branch-protection'.
#

GithubApi.SetAllowedActionsEnterprise

Configure allowed GitHub Actions for an enterprise. This tool sets the allowed GitHub Actions for a given enterprise. It is used when the enterprise's permission policy for `allowed_actions` is set to `selected`. Requires authentication with an `admin:enterprise` scope token.

Parameters

ParameterTypeReq.Description
allow_github_owned_actionsbooleanRequiredSet to true to allow GitHub-owned actions in the enterprise, such as those in the 'actions' organization.
allowed_action_patternsarray<string>RequiredList of patterns to match specific GitHub Actions to allow. Use wildcards, tags, and SHAs for specification.
enterprise_identifierstringRequiredThe slug version of the enterprise name or the enterprise ID.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/set-allowed-actions-enterprise'.
#

GithubApi.SetAllowedActionsForOrganization

Set allowed GitHub Actions for an organization. This tool sets which GitHub Actions are permitted in an organization, given the organization's permission policy is configured to 'selected'. It requires an access token with the 'admin:org' scope or GitHub App permissions for 'administration'. Use it when you need to update allowed actions based on organization or enterprise policies. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
organization_namestringOptionalThe name of the GitHub organization. It is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-allowed-actions-organization'.
#

GithubApi.SetBranchAppAccessRestrictions

Replace apps with push access on a protected branch. Use this tool to specify which GitHub Apps have push access to a protected branch, replacing any previous app list. It is applicable to public repositories with various GitHub plans and private repositories with higher-tier plans. Only GitHub Apps with write access to the contents permission can be authorized. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository. It is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
branch_namestringOptionalThe exact name of the branch to update app access restrictions for. Wildcard characters are not allowed. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/set-app-access-restrictions'.
#

GithubApi.SetBranchStatusCheckContexts

Set status check contexts for a protected branch. Utilize this tool to configure the required status check contexts for a protected branch in a GitHub repository. This tool is relevant for managing branch protections in public repositories with GitHub Free, and both public and private repositories with GitHub Pro, Team, Enterprise Cloud, and Server. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the GitHub repository. It is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
branch_namestringOptionalThe name of the branch. It cannot contain wildcard characters. Use the GraphQL API for wildcard support. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/set-status-check-contexts'.
#

GithubApi.SetBranchUserAccessRestrictions

Set user access restrictions for a GitHub branch. This tool replaces the list of users with push access to a specified GitHub branch, removing previous users and granting access to the new list. Useful for managing who can perform actions on protected branches. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. It is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the GitHub repository. Note that it is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
branch_namestringOptionalThe name of the branch for which to set user access restrictions. Cannot contain wildcard characters. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/set-user-access-restrictions'.
#

GithubApi.SetCheckSuitePreferences

Set preferences for check suite creation in a repository. Changes the default automatic flow for creating check suites in a GitHub repository. Use this tool to enable or disable the automatic creation of check suites when code is pushed. Requires admin permissions in the repository. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. This value is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the GitHub repository. This value is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'checks/set-suites-preferences'.
#

GithubApi.SetCustomLabelsForSelfHostedRunner

Set custom labels for a self-hosted runner in an enterprise. This tool updates the custom labels for a specific self-hosted runner in a GitHub enterprise, removing all previous labels. Requires an access token with `manage_runners:enterprise` scope.

Parameters

ParameterTypeReq.Description
custom_labelsarray<string>RequiredList of new custom labels for the runner. Use an empty list to remove all labels.
enterprise_identifierstringRequiredThe slug or ID of the enterprise where the runner is configured. Use the slug version of the enterprise name or the enterprise ID.
self_hosted_runner_idintegerRequiredThe unique identifier of the self-hosted runner to update labels for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/set-custom-labels-for-self-hosted-runner-for-enterprise'.
#

GithubApi.SetCustomLabelsRunnerOrg

Set custom labels for a self-hosted runner in an organization. Updates custom labels for a specified self-hosted runner in an organization, removing any previous labels. Requires authentication with an access token having `admin:org` scope.

Parameters

ParameterTypeReq.Description
custom_labelsarray<string>RequiredAn array of custom label names to assign to the runner. Pass an empty array to remove all labels.
organization_namestringRequiredThe name of the organization. This is not case sensitive.
runner_identifierintegerRequiredUnique identifier of the self-hosted runner to set custom labels.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-custom-labels-for-self-hosted-runner-for-org'.
#

GithubApi.SetDefaultGithubActionsPermissions

Configure default GitHub Actions permissions for an organization. This tool sets the default workflow permissions for the `GITHUB_TOKEN` in an organization and determines if GitHub Actions can submit approving pull request reviews. It's essential to authenticate using an access token with `admin:org` scope, or GitHub Apps must have the `administration` permission. Use it to manage organizational GitHub Actions settings.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. Not case sensitive.
allow_actions_to_approve_pull_requestsbooleanOptionalAllow GitHub Actions to approve pull requests. Enabling this may pose a security risk.
default_github_token_permissionsstringOptionalThe default permissions granted to the GITHUB_TOKEN when running workflows. Options are 'read' or 'write'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-github-actions-default-workflow-permissions-organization'.
#

GithubApi.SetEnterpriseWorkflowPermissions

Set default GitHub Actions permissions for an enterprise. Use this tool to set the default workflow permissions for the `GITHUB_TOKEN` in GitHub enterprise workflows, and determine if GitHub Actions can approve pull request reviews. Authentication with an `admin:enterprise` scoped token is required.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID of the enterprise. Use the slug version of the enterprise name or the enterprise ID.
allow_approve_pull_request_reviewsbooleanOptionalIndicate if GitHub Actions can approve pull requests. Enabling this may pose a security risk.
default_workflow_permissionsstringOptionalSpecify 'read' or 'write' to set the permissions for the GITHUB_TOKEN when running workflows.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-github-actions-default-workflow-permissions-enterprise'.
#

GithubApi.SetGhOrgAccessToRunnerGroup

Update organization access for a GitHub runner group. This tool allows updating which organizations have access to a self-hosted runner group within a GitHub enterprise. It requires authentication with a token that has the 'manage_runners:enterprise' scope.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID of the enterprise. Specify either for identifying the enterprise.
organization_ids_for_runner_accessarray<integer>RequiredList of organization IDs permitted to access the self-hosted runner group.
runner_group_identifierintegerRequiredUnique integer identifier of the self-hosted runner group within the enterprise.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/set-org-access-to-self-hosted-runner-group-in-enterprise'.
#

GithubApi.SetGithubActionsAllowedInRepo

Set allowed GitHub Actions in a repository. Configure which GitHub Actions are permitted in a specific repository. Requires repository permission policy to be set to 'selected' and appropriate authentication. Cannot override organization-level settings. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the GitHub repository. This is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-allowed-actions-repository'.
#

GithubApi.SetGithubActionsCachePolicy

Set GitHub Actions cache usage policy for an enterprise. This tool sets the cache usage policy for GitHub Actions within a specific enterprise. Requires authentication with an access token having `admin:enterprise` scope or an appropriate GitHub App permission.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID of the enterprise for which to set the cache policy.
default_repo_cache_size_limit_gbintegerOptionalDefault size limit for all caches in a repository, specified in gigabytes.
maximum_repository_cache_size_limit_in_gbintegerOptionalMaximum cache size limit for all repository caches in an enterprise, in gigabytes.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-actions-cache-usage-policy-for-enterprise'.
#

GithubApi.SetGithubActionsEnabledOrgs

Replace organizations enabled for GitHub Actions in an enterprise. Use this tool to update the list of organizations enabled for GitHub Actions within a specific enterprise. It requires the enterprise's permission policy to be set to 'selected'. Ensure authentication with an access token having the 'admin:enterprise' scope.

Parameters

ParameterTypeReq.Description
enterprise_slug_or_idstringRequiredThe slug version or ID of the enterprise for which to update enabled GitHub Actions organizations.
organization_ids_for_github_actionsarray<integer>RequiredAn array of organization IDs to enable GitHub Actions for specific organizations in the enterprise.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/set-selected-organizations-enabled-github-actions-enterprise'.
#

GithubApi.SetGithubActionsPermissions

Set GitHub Actions permissions for an enterprise. Set the permissions policy for GitHub Actions within an enterprise. Requires admin authentication with the `admin:enterprise` scope.

Parameters

ParameterTypeReq.Description
enabled_organizations_policystringRequiredSpecifies which organizations can run GitHub Actions: 'all', 'none', or 'selected'.
enterprise_identifierstringRequiredThe slug or ID of the enterprise for setting GitHub Actions permissions.
actions_permission_policystringOptionalSpecifies the actions allowed to run in the enterprise. Possible values: 'all', 'local_only', 'selected'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/set-github-actions-permissions-enterprise'.
#

GithubApi.SetGithubActionsReposForOrg

Configure selected repositories for GitHub Actions in an organization. This tool replaces the list of repositories with GitHub Actions enabled in a specified organization. Use it when you need to manage which repositories have access to GitHub Actions, provided the organization policy allows it. Requires authentication with an access token granting `admin:org` scope or a GitHub App with `administration` permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. It is not case sensitive.
repository_ids_for_github_actionsarray<integer>RequiredAn array of repository IDs to enable for GitHub Actions within the organization. Each ID should be an integer.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-selected-repositories-enabled-github-actions-organization'.
#

GithubApi.SetGithubAnnouncement

Set the announcement banner message and expiration in GitHub Enterprise. Use this tool to configure the global announcement banner message and expiration time in your GitHub Enterprise. This is useful for communicating important messages to all users in the enterprise.

Parameters

ParameterTypeReq.Description
announcement_text_gfmstringRequiredThe announcement text in GitHub Flavored Markdown. Use for global messages in GitHub Enterprise.
announcement_expiration_timestringOptionalTimestamp for when the announcement expires in ISO 8601 format. Use `null` or an empty string for no expiration.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/set-announcement'.
#

GithubApi.SetGithubBranchTeamAccess

Update the team access restrictions on a GitHub branch. This tool replaces the current list of teams with push access to a specified branch in a GitHub repository. It removes all previous teams and sets the new list, including any child teams, for team access control. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the GitHub repository. This value is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
branch_namestringOptionalThe name of the branch. It cannot contain wildcard characters. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/set-team-access-restrictions'.
#

GithubApi.SetGithubEnterpriseSettings

Apply configuration settings to GitHub Enterprise instance. This tool applies a set of customizable settings to a GitHub Enterprise instance. It should be called when there is a need to update configuration parameters. Refer to the documentation for a list of settings that can be changed through this tool.

Parameters

ParameterTypeReq.Description
new_settings_json_stringstringRequiredA JSON string specifying new settings to apply to the GitHub Enterprise instance. Only include settings you wish to change.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/set-settings'.
#

GithubApi.SetGithubIssueLabels

Set new labels for a GitHub issue. Use this tool to remove all existing labels and apply new labels to a specified issue in a GitHub repository. Ideal for organizing and categorizing issues effectively. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe GitHub username or organization name of the repository owner. Not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository. This is not case sensitive and identifies the repository within which the issue resides. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
issue_numberintegerOptionalThe unique identifier number for the GitHub issue to update labels. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/set-labels'.
#

GithubApi.SetGithubOidcSubjectClaim

Customize OIDC subject claim for a GitHub repository. This tool is used to set the customization template and opt-in or opt-out flag for an OpenID Connect (OIDC) subject claim in a GitHub repository. It requires authentication with a token having `repo` scope or GitHub App permissions with `actions:write`.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. This value is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Not case sensitive.
use_default_templatebooleanRequiredSet to true to use the default template, which ignores `include_claim_keys`.
claim_keys_to_includearray<string>OptionalArray of unique strings for claim keys, containing only alphanumeric characters and underscores.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-custom-oidc-sub-claim-for-repo'.
#

GithubApi.SetGithubReposForRequiredWorkflow

Set repositories for a GitHub required workflow. This tool sets the repositories associated with a GitHub required workflow. Use it when you need to configure or update which repositories are subject to a required workflow. Authentication with an access token and the `admin:org` scope is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization name. Input is not case sensitive.
repository_ids_for_required_workflowarray<integer>RequiredAn array of repository IDs for which the workflow is required. Provide each repository's ID as an integer.
required_workflow_identifierintegerRequiredThe unique identifier for the required workflow you want to set for the repositories.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-selected-repos-to-required-workflow'.
#

GithubApi.SetGithubRunnerGroupRepoAccess

Update repository access for a GitHub runner group. Replaces the list of repositories that can access a self-hosted runner group in a GitHub organization. Requires authentication with an access token having the `admin:org` scope.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
repository_ids_for_accessarray<integer>RequiredList of repository IDs allowed to access the self-hosted runner group.
runner_group_idintegerRequiredUnique identifier for the self-hosted runner group in the organization.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-repo-access-to-self-hosted-runner-group-in-org'.
#

GithubApi.SetOrgAnnouncementBanner

Sets the announcement banner for a GitHub organization. Use this tool to update the announcement banner displayed for a specified GitHub organization.

Parameters

ParameterTypeReq.Description
announcement_textstringRequiredThe announcement text formatted in GitHub Flavored Markdown. See GitHub's basic writing syntax for details.
organization_namestringRequiredThe name of the GitHub organization. The name is not case sensitive.
announcement_expiry_timestringOptionalThe expiry time for the announcement, in ISO 8601 format. Use `null` or empty for no expiry.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'announcement-banners/set-announcement-banner-for-org'.
#

GithubApi.SetOrgVariableRepos

Replace repositories for an organization's variable. This tool replaces all repositories associated with an organization variable that is set to selected visibility. Use it to update the repositories list where an org variable is available. Requires appropriate authentication and permissions.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. It is not case sensitive.
repository_ids_for_accessarray<integer>RequiredAn array of integers representing the repository IDs that can access the organization variable. Ensure the IDs are valid and accessible.
variable_namestringRequiredThe name of the organization variable to be updated.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-selected-repos-for-org-variable'.
#

GithubApi.SetOwnGithubPublicMembership

Publicize your GitHub organization membership. Use this tool to make your GitHub organization membership public. It can only be used for your own membership, not for others.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user account handle to publicize the membership for.
organization_namestringRequiredThe GitHub organization name to make membership public. Case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/set-public-membership-for-authenticated-user'.
#

GithubApi.SetReposForOrgSecret

Update selected repos for an organization's Dependabot secret. This tool updates the list of repositories associated with a Dependabot secret for an organization, when the visibility is set to 'selected'. It requires authentication with an access token with 'admin:org' scope or a GitHub App with 'dependabot_secrets' permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
secret_namestringRequiredThe name of the organization secret to update the repository access for. This should match the name of an existing Dependabot secret.
selected_repository_idsarray<integer>RequiredList of repository IDs that can access the org secret. Use only when visibility is 'selected'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/set-selected-repos-for-org-secret'.
#

GithubApi.SetRepoSubscription

Manage your GitHub repository subscription settings. Use this tool to subscribe to or ignore notifications for a GitHub repository. Set `subscribed` to `true` to watch the repository, or set `ignored` to `true` to ignore notifications. This tool does not delete subscriptions; use a different endpoint for that.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredSpecify the name of the GitHub repository to manage subscriptions. Not case sensitive.
repository_ownerstringRequiredThe username of the repository owner. Not case sensitive.
block_notificationsbooleanOptionalSet to true to block all notifications from this repository.
receive_notificationsbooleanOptionalSet to `true` to receive notifications from the repository.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/set-repo-subscription'.
#

GithubApi.SetRunnerLabels

Update custom labels for a self-hosted runner in a GitHub repo. This tool removes existing custom labels and sets new ones for a specific self-hosted runner in a GitHub repository. It requires authentication with an access token that has the 'repo' scope.

Parameters

ParameterTypeReq.Description
custom_labels_for_runnerarray<string>RequiredAn array of custom labels to set for the self-hosted runner. Pass an empty array to clear all labels.
repository_namestringRequiredThe name of the GitHub repository. This is not case-sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. This name is not case sensitive.
runner_idintegerRequiredThe unique integer identifier of the self-hosted runner to update labels for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-custom-labels-for-self-hosted-runner-for-repo'.
#

GithubApi.SetWorkflowAccess

Set the access level for workflows in a repository. Adjusts the access level for workflows and reusable workflows in internal or private GitHub repositories. Requires authentication with a token that has the `repo` scope or a GitHub App with `administration` permissions.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This is not case sensitive.
repository_ownerstringRequiredThe GitHub username or organization name that owns the repository. This is not case sensitive.
workflow_access_levelstringRequiredSpecifies access level for workflows outside the repository: 'none', 'user', or 'organization'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-workflow-access-to-repository'.
#

GithubApi.StarGithubGist

Star a gist on GitHub using its gist ID. Use this tool to star a specific gist on GitHub by providing its gist ID. This action marks the gist as starred for the authenticated user.

Parameters

ParameterTypeReq.Description
gist_unique_idstringRequiredThe unique identifier of the gist to be starred on GitHub.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/star'.
#

GithubApi.StarGithubRepository

Star a GitHub repository for the authenticated user. Use this tool to star a specific GitHub repository on behalf of the authenticated user. This action can be used to bookmark important repositories or show appreciation for the work. Ensure the `Content-Length` is set to zero when making the request.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository to star. This name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository, case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/star-repo-for-authenticated-user'.
#

GithubApi.StartGithubConfiguration

Initiate the GitHub configuration process. Use this tool to start the configuration process for updated GitHub Enterprise settings. It should be called when you need changes to your GitHub settings to take effect.

Parameters

No parameters required.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/start-configuration-process'.
#

GithubApi.StartOrgMigration

Initiates a migration archive for a GitHub organization. Use this tool to start the process of generating a migration archive for a specified GitHub organization. This is useful for moving or backing up repositories and data from an organization.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. The name is not case sensitive.
repositories_to_migratearray<string>RequiredA list of repository names to be included in the migration process.
exclude_attachmentsbooleanOptionalSet to true to exclude attachments from the migration, reducing archive file size.
exclude_git_databooleanOptionalSet to true to exclude repository git data from the migration, reducing archive size. Useful for metadata-only migrations.
exclude_itemsarray<string>OptionalSpecify related items to exclude from the response for performance optimization, e.g., ["repositories"].
exclude_metadatabooleanOptionalSet to true to exclude metadata, including only git source. Useful for reducing file complexity.
exclude_owner_projectsbooleanOptionalIndicate whether projects owned by the organization or users should be excluded from the migration.
exclude_releasesbooleanOptionalSet to true to exclude releases from the migration archive, reducing file size.
lock_repositoriesbooleanOptionalSet to true to lock repositories during migration, preventing changes.
only_include_org_metadatabooleanOptionalSpecify whether only organization metadata is included, keeping the repositories array empty and ignoring other flags.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'migrations/start-for-org'.
#

GithubApi.SubmitPullRequestReview

Submit a review for a pull request on GitHub. Use this tool to submit a pending review for a specific pull request on GitHub. It can be used to approve, reject, or comment on changes in a pull request after a review has been created.

Parameters

ParameterTypeReq.Description
pull_request_numberintegerRequiredThe identifier number of the pull request to be reviewed.
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Input is case insensitive.
review_actionstringRequiredSpecify the review action: `APPROVE`, `REQUEST_CHANGES`, or `COMMENT`. Leaving this empty sets the review to `PENDING`.
review_identifierintegerRequiredThe unique identifier for the pull request review to be submitted.
review_body_textstringOptionalThe body text of the pull request review. Provide detailed feedback or comments for the review.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/submit-review'.
#

GithubApi.SuspendGithubAppInstallation

Suspend a GitHub App's installation for specified accounts. Use this tool to suspend a GitHub App on a user, organization, or business account. This blocks the app from accessing the account's resources via the GitHub Enterprise Server API or webhook events. Note: A JWT is required for authentication.

Parameters

ParameterTypeReq.Description
installation_idintegerRequiredThe unique identifier of the GitHub App installation to suspend.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/suspend-installation'.
#

GithubApi.SuspendGithubUser

Suspend a user on a GitHub Enterprise instance. Use this tool to suspend a non-Active Directory LDAP-authenticated user on a GitHub Enterprise instance. Ensure the user is not authenticated via Active Directory LDAP as the API will not support it and will return a 403 response. This action cannot be performed on your own account.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub username to suspend, excluding Active Directory LDAP-authenticated users.
suspension_reasonstringOptionalA string detailing why the user is being suspended, which will be logged in the audit log. If omitted, a default message is used.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/suspend-user'.
#

GithubApi.SyncForkWithUpstream

Sync a forked repository's branch with the upstream repo. Use this tool to update a branch of a forked GitHub repository, ensuring it is up-to-date with changes from the upstream repository.

Parameters

ParameterTypeReq.Description
branch_name_to_syncstringRequiredThe name of the branch in the forked repository to update with upstream changes.
repository_namestringRequiredThe name of the repository to update. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. Not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/merge-upstream'.
#

GithubApi.SyncGithubLdapUserMapping

Queue a sync job for LDAP mapping of a GitHub user. Use this tool to queue a job to sync LDAP mapping for a specific GitHub user. This does not initiate immediate synchronization but queues it for when the instance is ready. A response of `201` indicates successful queuing.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user account handle to queue LDAP sync for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/sync-ldap-mapping-for-user'.
#

GithubApi.ToggleMaintenanceMode

Toggle GitHub Enterprise maintenance mode. This tool enables or disables maintenance mode for a GitHub Enterprise instance. It should be called when you want to toggle the maintenance mode setting. The response indicates whether the operation was successful.

Parameters

ParameterTypeReq.Description
maintenance_mode_settingsstringRequiredA JSON string defining `enabled` (true/false) and `when` (e.g., 'now' or a chronic-parseable date) to set maintenance mode status and timing.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/enable-or-disable-maintenance-mode'.
#

GithubApi.TransferGithubRepository

Initiate the transfer of a GitHub repository to a new owner. This tool starts the process of transferring a GitHub repository to another user. The new owner must accept the transfer when moving a personal repository. The response provides information about the original owner and continues the transfer asynchronously. For more details, refer to GitHub's documentation on repository transfers.

Parameters

ParameterTypeReq.Description
new_owner_username_or_orgstringRequiredThe username or organization name to which the repository will be transferred.
repository_namestringRequiredThe name of the repository to be transferred. Case-insensitive.
repository_ownerstringRequiredThe account owner of the repository. Case insensitive.
new_repository_namestringOptionalThe new name to be given to the repository. It should be a valid GitHub repository name.
team_ids_to_addarray<integer>OptionalList of team IDs to add to the repository. Applicable only for organization-owned repositories.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/transfer'.
#

GithubApi.TriggerEnvironmentDownload

Start a new download of the environment tarball. This tool triggers a new download of the environment tarball based on the specified `image_url`. Once completed, the downloaded tarball replaces the existing environment. It should be called when a new version of the environment is needed. If a download cannot be started due to constraints like ongoing downloads or protected environments, an error will be provided.

Parameters

ParameterTypeReq.Description
pre_receive_environment_idintegerRequiredThe unique identifier for the pre-receive environment to trigger the download for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/start-pre-receive-environment-download'.
#

GithubApi.TriggerGithubCheckRerequest

Triggers a rerequest for an existing GitHub check run. This tool triggers GitHub to rerequest an existing check run without needing to push new code. Ideal for resetting the status of check runs to 'queued' and clearing the conclusion. It requires the `checks:read` permission for private repositories or pull access for public ones.

Parameters

ParameterTypeReq.Description
check_run_identifierintegerRequiredThe unique identifier for the GitHub check run to be rerequested.
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_owner_accountstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'checks/rerequest-run'.
#

GithubApi.TriggerGithubDispatchEvent

Triggers a GitHub repository dispatch event. Use this tool to activate a webhook event called `repository_dispatch` to trigger a GitHub Actions workflow or GitHub App webhook. It requires write access to the repository via personal access tokens or GitHub App permissions. You can include additional data using `client_payload` to pass on extra information needed by your workflow. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalSpecify the GitHub username or organization name that owns the repository. This is not case-sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository. This is not case sensitive and determines which repository's dispatch event will be triggered. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-dispatch-event'.
#

GithubApi.TriggerGithubWebhookPing

Trigger a ping event to a GitHub webhook. This tool sends a ping event to the specified GitHub webhook to test connectivity or configuration. It should be called when it's necessary to verify if the webhook setup is correct.

Parameters

ParameterTypeReq.Description
webhook_hook_idintegerRequiredThe unique identifier of the GitHub webhook to ping.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/ping-global-webhook'.
#

GithubApi.TriggerGithubWebhookTest

Trigger a GitHub webhook test with the latest push event. This tool triggers a GitHub webhook for push events on the specified repository. It should be called when you need to test if a webhook is configured correctly and subscribed to `push` events. If successful, the tool will confirm the test was triggered; otherwise, it will indicate a lack of subscription.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. This parameter is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is not case sensitive.
webhook_identifierintegerRequiredThe unique identifier of the webhook to be tested. This integer value specifies which webhook to trigger in the repository.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/test-push-webhook'.
#

GithubApi.UnfollowGithubUser

Unfollow a user on GitHub. Use this tool to unfollow a user on GitHub. Ensure the user is authenticated with basic auth or OAuth with the `user:follow` scope.

Parameters

ParameterTypeReq.Description
github_user_handle_to_unfollowstringRequiredThe GitHub user's handle you want to unfollow. The user must be logged in and authenticated.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/unfollow'.
#

GithubApi.UninstallGithubApp

Uninstall a GitHub App from an account. This tool is used to uninstall a GitHub App from a user, organization, or business account. It should be called when you want to permanently remove an app's access. For temporary suspension, consider using the suspend endpoint instead. Authentication requires a JWT.

Parameters

ParameterTypeReq.Description
installation_idintegerRequiredThe unique identifier of the GitHub App installation to uninstall.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/delete-installation'.
#

GithubApi.UnlinkExternalIdpGroupFromTeam

Unlink an external IdP group from a GitHub team. This tool is used to remove a connection between a GitHub team and an external identity provider group. It is useful when managing team membership through an IdP in GitHub Enterprise Cloud.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. This is not case sensitive.
team_slugstringRequiredThe slug of the team's name. It identifies the team within the organization.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/unlink-external-idp-group-from-team-for-org'.
#

GithubApi.UnlockGithubIssue

Unlock a locked GitHub issue conversation. Use this tool to unlock a previously locked conversation on a GitHub issue if you have push access to the repository. This action is useful when you need to re-enable discussion on an issue.

Parameters

ParameterTypeReq.Description
issue_idintegerRequiredThe unique identifier for the GitHub issue to be unlocked.
repository_namestringRequiredThe name of the GitHub repository. Not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/unlock'.
#

GithubApi.UnlockGithubRepoForOrgMigration

Unlock a locked repository after migration for an organization. Use this tool to unlock a repository that was locked for a migration within an organization on GitHub. This is necessary after completing a migration to access the repository again. Once unlocked, consider deleting the repository if you no longer need the source data.

Parameters

ParameterTypeReq.Description
migration_unique_identifierintegerRequiredThe unique identifier for the migration process.
organization_namestringRequiredThe GitHub organization name, which is not case sensitive.
repository_namestringRequiredThe name of the repository to be unlocked. This is required and should match the exact repository name used during the migration. Case sensitivity does not matter.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'migrations/unlock-repo-for-org'.
#

GithubApi.UnstarGithubGist

Unstar a GitHub gist by its ID. This tool is used to remove a star from a specific GitHub gist identified by its ID. Call this tool when you need to unstar a gist to update its starred status. It confirms the action has been completed.

Parameters

ParameterTypeReq.Description
gist_identifierstringRequiredThe unique identifier for the GitHub gist to be unstarred.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/unstar'.
#

GithubApi.UnstarGithubRepo

Unstar a GitHub repository for the authenticated user. Use this tool to remove a star from a repository on GitHub for the currently authenticated user. This action is useful when a user wants to unmark a repository as a favorite or remove it from a list of starred repositories.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository to unstar, not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/unstar-repo-for-authenticated-user'.
#

GithubApi.UnsubscribeFromRepo

Stop receiving notifications for a repository. Use this tool to stop watching a GitHub repository and cease receiving notifications from it. This action will unsubscribe you from updates related to the specified repository.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository to unsubscribe from. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. It is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'activity/delete-repo-subscription'.
#

GithubApi.UnsuspendGithubUser

Unsuspend a user on GitHub Enterprise. This tool unsuspends a user on a GitHub Enterprise instance. It is disabled if the GitHub instance uses LDAP Sync with Active Directory LDAP servers, in which case it returns a `403` response. It should be called to restore access to a suspended user.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub user handle to identify the user account to unsuspend.
unsuspension_reasonstringOptionalThe reason for unsuspending the user, logged in the audit log. Defaults to "Unsuspended via API by _SITE_ADMINISTRATOR_" if not provided.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/unsuspend-user'.
#

GithubApi.UpdateBranchProtection

Update GitHub repository branch protection settings. Use this tool to update the protection settings of a branch in a GitHub repository. It requires admin or owner permissions. Note that specifying new arrays for users and teams will replace their previous values, and there is a limit of 100 items for users, apps, and teams combined. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository on GitHub. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the GitHub repository, which is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
branch_namestringOptionalThe name of the branch to update protection settings for. It cannot contain wildcard characters. For wildcard support, use the GraphQL API. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/update-branch-protection'.
#

GithubApi.UpdateBranchStatusCheckProtection

Update status check protection for a GitHub branch. Use this tool to update the required status checks for a protected branch in a GitHub repository. Requires admin or owner permissions. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the GitHub repository. It is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
branch_namestringOptionalThe name of the branch for which to update status check protection. Wildcard characters are not allowed. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/update-status-check-protection'.
#

GithubApi.UpdateCheckRunStatus

Update a check run for a specific commit in a repository. This tool updates a check run for a specific commit within a repository. It is useful when you need to modify the status or details of check runs created by a GitHub App. Ensure the app has the 'checks:write' permission to perform this action. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. This is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository to update the check run. It is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
check_run_identifierintegerOptionalThe unique identifier of the check run to update. This should be an integer value. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'checks/update'.
#

GithubApi.UpdateCommitComment

Update a comment on a GitHub commit. Use this tool to modify the text of an existing comment on a commit in a GitHub repository. Ideal for refining or correcting comments after they have been posted.

Parameters

ParameterTypeReq.Description
comment_contentsstringRequiredThe updated text of the commit comment. Enter the new content you wish to save.
comment_unique_idintegerRequiredThe unique identifier for the commit comment being updated. It is an integer value that specifies the comment to be edited within the repository.
repository_namestringRequiredThe name of the repository. This is not case sensitive. Provide the repository's exact name as it appears on GitHub.
repository_ownerstringRequiredThe GitHub account owner of the repository. This name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/update-commit-comment'.
#

GithubApi.UpdateDeploymentBranchPolicy

Update a deployment branch policy for a GitHub environment. This tool updates a deployment branch policy for a specified environment in a GitHub repository. It requires authentication with an access token that has the `repo` scope, or for GitHub Apps, the `administration:write` permission.

Parameters

ParameterTypeReq.Description
branch_name_patternstringRequiredPattern that branches must match to deploy to the environment. Wildcards won't match '/'. See Ruby File.fnmatch for syntax.
branch_policy_identifierintegerRequiredThe unique identifier for the branch policy to be updated.
environment_namestringRequiredThe name of the environment for which the deployment branch policy is being updated.
repository_namestringRequiredThe name of the GitHub repository. The name is not case sensitive.
repository_ownerstringRequiredThe GitHub username or organization name of the repository owner. It is case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/update-deployment-branch-policy'.
#

GithubApi.UpdateEnterpriseGroupAttributes

Update attributes for a provisioned enterprise group. This tool updates individual attributes of a provisioned group in an enterprise account using the SCIM API. Users can perform add, remove, or replace operations on group attributes or memberships. Useful for updating group values or managing memberships efficiently. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
scim_group_identifierstringOptionalA unique identifier for the SCIM group to be updated. This is required to specify which group's attributes or memberships are being modified. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/update-attribute-for-enterprise-group'.
#

GithubApi.UpdateEnterpriseGroupInfo

Replace all information for a provisioned enterprise group. Use this tool to replace an existing provisioned group's information entirely. All details must be provided anew, as any missing information will result in its removal, including membership. For partial updates, a different endpoint should be used. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
scim_group_identifierstringOptionalA unique identifier for the SCIM group to update. This is necessary for identifying the specific group to replace its information. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/set-information-for-provisioned-enterprise-group'.
#

GithubApi.UpdateEnterpriseUserAttribute

Update individual attributes for a provisioned enterprise user. Use this tool to modify attributes of a provisioned user in an enterprise setting using SCIM API operations. It allows adding, removing, or replacing user attributes. Note that complex path selectors and some operations like suspending a user may have specific caveats. Refer to the SCIM specification for operation format guidance. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
scim_user_idstringOptionalThe unique identifier for the SCIM user whose attributes you want to update. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/update-attribute-for-enterprise-user'.
#

GithubApi.UpdateGistComment

Update an existing comment on a GitHub gist. Use this tool to update a comment on a specific GitHub gist. Ideal for modifying content of a gist comment when changes are necessary.

Parameters

ParameterTypeReq.Description
comment_identifierintegerRequiredThe unique identifier of the comment to update.
comment_textstringRequiredThe text content of the gist comment to be updated.
gist_identifierstringRequiredThe unique identifier for the GitHub gist you want to update a comment on.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/update-comment'.
#

GithubApi.UpdateGithubActionsEnvVar

Update an environment variable in GitHub Actions workflow. Use this tool to update an environment variable within a specified GitHub Actions workflow environment. Requires authentication with a `repo` scope token or GitHub App with `environment:write` permissions.

Parameters

ParameterTypeReq.Description
environment_namestringRequiredThe name of the GitHub Actions workflow environment to update.
repository_idintegerRequiredThe unique identifier of the repository to update the environment variable in.
environment_variable_valuestringOptionalThe new value for the GitHub Actions environment variable.
variable_identifierstringOptionalThe name of the environment variable to update.
variable_namestringOptionalThe name of the environment variable to update in the GitHub Actions workflow.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/update-environment-variable'.
#

GithubApi.UpdateGithubAppWebhookConfig

Update the webhook configuration for a GitHub App. Use this tool to update the webhook configuration settings for a GitHub App. This requires authentication with a JSON Web Token (JWT). Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'apps/update-webhook-config-for-app'.
#

GithubApi.UpdateGithubCodeScanningAlert

Update the status of a GitHub code scanning alert. This tool updates the status of a code scanning alert on a GitHub repository. It's useful when you need to manage alert statuses for security reasons. Requires appropriate access token scopes.

Parameters

ParameterTypeReq.Description
alert_identifier_numberintegerRequiredThe unique number identifying a GitHub code scanning alert, found at the end of the alert URL or in the response of the alerts list.
alert_statestringRequiredSpecifies the new state of the code scanning alert. Use 'open' or 'dismissed'. Provide `dismissed_reason` if 'dismissed'.
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This is case insensitive.
dismissal_commentstringOptionalThe comment explaining the reason for dismissing the code scanning alert.
dismissed_reason_for_alertstringOptionalRequired if the alert state is dismissed. Specify the reason using one of: 'None', 'false positive', 'won't fix', 'used in tests'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'code-scanning/update-alert'.
#

GithubApi.UpdateGithubDependabotAlert

Update a GitHub Dependabot alert. Use this tool to update a Dependabot alert in a GitHub repository. Requires an access token with `security_events` scope for private repositories or `public_repo` scope for public repositories. GitHub Apps need **Dependabot alerts** write permission.

Parameters

ParameterTypeReq.Description
alert_identifierintegerRequiredThe unique number identifying a Dependabot alert in the repository. Find this at the end of the alert URL or in `number` fields from the `GET /repos/{owner}/{repo}/dependabot/alerts` response.
alert_statestringRequiredSpecifies the state of the Dependabot alert. Use 'dismissed' to dismiss an alert and 'open' to keep it open. A 'dismissed_reason' is required when setting to 'dismissed'.
repository_namestringRequiredThe name of the GitHub repository to update. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the GitHub repository. Not case sensitive.
dismissed_alert_commentstringOptionalAn optional comment to provide context when dismissing the alert.
dismissed_reason_for_alertstringOptionalReason for dismissing the alert. Required if `state` is set to `dismissed`. Allowed values: 'fix_started', 'inaccurate', 'no_bandwidth', 'not_used', 'tolerable_risk'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/update-alert'.
#

GithubApi.UpdateGithubDiscussionComment

Updates a GitHub discussion comment's text. This tool edits the body text of a discussion comment in a GitHub organization team. Use it when you need to update the content of a comment in a team discussion. Requires OAuth access tokens with `write:discussion` scope.

Parameters

ParameterTypeReq.Description
comment_identifierintegerRequiredA unique integer identifying the comment to be updated in the discussion.
discussion_comment_bodystringRequiredThe new text for the discussion comment to be updated.
discussion_idintegerRequiredThe unique number identifying the GitHub discussion to update the comment in.
organization_namestringRequiredThe name of the GitHub organization. It is not case-sensitive.
team_slugstringRequiredThe slug of the team name. This is used to specify the team in the organization.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/update-discussion-comment-in-org'.
#

GithubApi.UpdateGithubGist

Update a GitHub gist's description and files. Use this tool to change the description, update, delete, or rename files in an existing GitHub gist. Unchanged files remain the same. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
gist_unique_identifierstringOptionalThe unique identifier of the GitHub gist to be updated. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'gists/update'.
#

GithubApi.UpdateGithubIssue

Update details of a GitHub issue. Use this tool when you need to update the information of an existing GitHub issue. Suitable for issue owners or users with push access. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the GitHub repository, case insensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository to update the issue in. It is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
issue_identifierintegerOptionalThe unique number identifying the GitHub issue to update. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/update'.
#

GithubApi.UpdateGithubIssueComment

Update a comment on a GitHub issue. This tool updates a specific comment on a GitHub issue. It should be called when an existing comment needs to be edited or corrected.

Parameters

ParameterTypeReq.Description
comment_contentsstringRequiredThe new text for the GitHub issue comment. This will replace the current contents of the comment.
comment_identifierintegerRequiredThe unique numerical identifier of the GitHub issue comment to update.
repository_namestringRequiredThe name of the repository. It is case-insensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository. The name is not case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/update-comment'.
#

GithubApi.UpdateGithubLabel

Update a label on a GitHub repository. Use this tool to update a label in a specified GitHub repository. It is useful when label details need modification, such as changing the name or color.

Parameters

ParameterTypeReq.Description
current_label_namestringRequiredThe current name of the label to be updated. It should match exactly the label's existing name.
repository_namestringRequiredThe name of the repository to update the label in. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
label_color_hex_codestringOptionalThe hexadecimal color code for the label, excluding the leading `#`.
label_descriptionstringOptionalA short description of the label, limited to 100 characters or fewer.
new_label_namestringOptionalThe updated label name for the GitHub label. Emojis can be embedded using native or colon-style markup (e.g., :strawberry:). For available emojis, refer to the Emoji cheat sheet.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/update-label'.
#

GithubApi.UpdateGithubMilestone

Update a GitHub repository milestone. Use to modify an existing milestone in a GitHub repository, such as changing due dates, titles, or descriptions.

Parameters

ParameterTypeReq.Description
milestone_idintegerRequiredThe unique number identifying the milestone to update.
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
milestone_descriptionstringOptionalA brief description of the milestone to be updated.
milestone_due_datestringOptionalThe due date for the milestone in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.
milestone_statestringOptionalThe state of the milestone. Accepted values are 'open' or 'closed'.
milestone_titlestringOptionalThe title of the milestone to be updated in the GitHub repository.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'issues/update-milestone'.
#

GithubApi.UpdateGithubOidcTemplate

Update OIDC custom subject claim template for GitHub organization. This tool updates or creates the customization template for an OpenID Connect (OIDC) subject claim for a GitHub organization. Requires an access token with the `write:org` scope or GitHub Apps with `admin:org` permission.

Parameters

ParameterTypeReq.Description
include_claim_keysarray<string>RequiredArray of unique strings for OIDC claim keys with alphanumeric characters and underscores.
organization_namestringRequiredThe name of the GitHub organization. Case insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'oidc/update-oidc-custom-sub-template-for-org'.
#

GithubApi.UpdateGithubOrgActionVariable

Update an organization variable in GitHub Actions. This tool updates a specified variable for an organization in GitHub Actions workflows. Authentication with an access token having `admin:org` scope or GitHub App with `organization_actions_variables:write` permission is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe GitHub organization's name. This name is not case sensitive.
repository_ids_for_selected_visibilityarray<integer>OptionalAn array of repository IDs that can access the organization variable. Only provide when `visibility` is set to `selected`.
repository_visibility_typestringOptionalSpecifies which repositories in the organization can access the variable. Options: `all`, `private`, `selected`.
var_namestringOptionalSpecify the name of the GitHub organization variable to update.
variable_namestringOptionalThe name of the organization variable to update. This is case-insensitive.
variable_valuestringOptionalThe new value to assign to the organization variable. It must be a string.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/update-org-variable'.
#

GithubApi.UpdateGithubOrganization

Update a GitHub organization's profile and member privileges. Allows an authenticated organization owner to update the organization's profile and set member privileges using the `admin:org` scope. New parameters enable more granular permissions for repository creation. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
organization_namestringOptionalThe GitHub organization name. This is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/update'.
#

GithubApi.UpdateGithubOrgMembership

Update your GitHub organization membership settings. This tool updates the membership status for the authenticated user in a specified GitHub organization. It is useful for changing your role or settings within an organization.

Parameters

ParameterTypeReq.Description
membership_statestringRequiredSet the state of the membership. Only accepts "active".
organization_namestringRequiredThe name of the GitHub organization. This should not be case sensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/update-membership-for-authenticated-user'.
#

GithubApi.UpdateGithubOrgName

Updates the organization name on GitHub Enterprise. Use this tool to update the name of an organization in GitHub Enterprise Administration. Ideal for managing organizational details in GitHub Enterprise settings.

Parameters

ParameterTypeReq.Description
current_organization_namestringRequiredThe current name of the organization to be updated. It is not case sensitive.
new_organization_namestringRequiredThe new name for the organization on GitHub Enterprise. This will be the name you want to update to.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/update-org-name'.
#

GithubApi.UpdateGithubOrgSecret

Create or update a GitHub organization secret. Use this tool to create or update an organization's secret on GitHub, encrypted with LibSodium. Requires an access token with `admin:org` scope or a GitHub App with `dependabot_secrets` organization permission.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization, not case sensitive.
repository_access_typestringRequiredDetermines which organization repositories can access the secret: 'all', 'private', or 'selected' (which requires specifying `selected_repository_ids`).
secret_namestringRequiredThe name of the secret to create or update. This should be a unique identifier for the secret within the organization.
encrypted_secret_valuestringOptionalThe secret value encrypted using LibSodium with the organization public key.
encryption_key_idstringOptionalThe ID of the key used to encrypt the organization secret, required for security verification.
selected_repository_ids_to_includearray<string>OptionalArray of repository IDs allowed to access the secret. Used when visibility is set to 'selected'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'dependabot/create-or-update-org-secret'.
#

GithubApi.UpdateGithubOrgWebhook

Update a webhook configured in a GitHub organization. Use this tool to update a webhook in a GitHub organization. When updating, ensure to provide the current or new secret if one was previously set to avoid its removal. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
organization_namestringOptionalThe name of the GitHub organization; not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
webhook_identifierintegerOptionalThe unique identifier of the webhook to be updated. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/update-webhook'.
#

GithubApi.UpdateGithubPagesInfo

Update information for a GitHub Pages site. Use this tool to update settings or information for a GitHub Pages site on a repository. The user must have appropriate permissions, such as repository administrator, maintainer, or 'manage GitHub Pages settings' permission. Requires a token with 'repo' scope or Pages write permission. GitHub Apps need 'administration:write' and 'pages:write' permissions. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. This value is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/update-information-about-pages-site'.
#

GithubApi.UpdateGithubPreReceiveEnvironment

Update a pre-receive environment in GitHub Enterprise. Use this tool to update a specific pre-receive environment in a GitHub Enterprise setup. Note that the default environment cannot be modified.

Parameters

ParameterTypeReq.Description
pre_receive_environment_idintegerRequiredThe unique identifier of the pre-receive environment to update.
new_environment_namestringOptionalThe new name for the pre-receive environment.
tarball_download_urlstringOptionalThe URL to download the tarball for the environment update.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/update-pre-receive-environment'.
#

GithubApi.UpdateGithubPreReceiveHook

Update a GitHub enterprise pre-receive hook. Use this tool to update details of a pre-receive hook in a GitHub enterprise environment. This is useful for modifying hook settings or configurations. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
pre_receive_hook_idintegerOptionalThe unique identifier of the pre-receive hook in the GitHub enterprise environment. This is required for updating hook details. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/update-pre-receive-hook'.
#

GithubApi.UpdateGithubProfile

Update your authenticated GitHub user profile. Use this tool to update the profile information of your authenticated GitHub account. Note that if your email is private and included in the update, it will remain hidden according to your privacy settings.

Parameters

ParameterTypeReq.Description
is_hireablebooleanOptionalSet to true if the user is available for hire, false otherwise.
new_blog_urlstringOptionalThe new blog URL to update on your GitHub profile.
new_company_namestringOptionalThe new company name to update on the GitHub profile.
new_locationstringOptionalThe location to update in the user’s GitHub profile.
new_twitter_usernamestringOptionalThe new Twitter username for the user to update in their GitHub profile.
new_user_biographystringOptionalThe new short biography of the user for the GitHub profile update.
new_user_namestringOptionalThe new name to update on the user's GitHub profile.
public_visible_email_addressstringOptionalThe email address you want to be publicly visible on your GitHub profile. If your privacy settings hide your email, it will remain hidden.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/update-authenticated'.
#

GithubApi.UpdateGithubProjectCard

Update an existing project card on GitHub. Use this tool to modify the details of a project card in a GitHub project. Ideal for updating card information such as changing the note or moving it between columns.

Parameters

ParameterTypeReq.Description
card_identifierintegerRequiredThe unique identifier of the GitHub project card to be updated.
card_notestringOptionalThe text note associated with the project card. It can include details or remarks.
set_card_archived_statusbooleanOptionalSpecify true to archive the card or false to unarchive it.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/update-card'.
#

GithubApi.UpdateGithubRelease

Edit a GitHub release with push access. Use this tool when you need to modify an existing release on a GitHub repository for which you have push access. It allows updating release information such as the title, description, and other metadata.

Parameters

ParameterTypeReq.Description
release_identifierintegerRequiredThe unique integer identifier for the GitHub release to be updated.
repository_namestringRequiredThe name of the repository. This field is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
commitish_valuestringOptionalDetermines the source for the Git tag; can be a branch or commit SHA. Defaults to the repo's default branch if the tag exists.
is_draftbooleanOptionalSet to `true` to make the release a draft, `false` to publish it.
mark_as_prereleasebooleanOptionalSet `true` to mark the release as a prerelease, or `false` to identify as a full release.
release_descriptionstringOptionalText describing the contents and details of the release tag.
release_namestringOptionalThe name of the release to be updated in the repository. This is a user-friendly name for the release.
release_tag_namestringOptionalThe name of the tag for the GitHub release. Used to identify the release version.
set_as_latest_releasebooleanOptionalSpecifies if this release should be the latest. Use 'true', 'false', or 'legacy'. Drafts/prereleases aren't eligible.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/update-release'.
#

GithubApi.UpdateGithubRepository

Update repository details on GitHub. This tool updates the details of a specified GitHub repository. Note: To modify a repository's topics, a different endpoint should be used. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository to update, not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/update'.
#

GithubApi.UpdateGithubRepoTopics

Replace topics for a specific GitHub repository. Use this tool to replace all topics for a specified GitHub repository, allowing easy management and categorization of projects.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the GitHub repository. It is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
repository_topic_namesarray<string>RequiredAn array of topics to replace existing repository topics. To clear all topics, send an empty array. Topics must be lowercase.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/replace-all-topics'.
#

GithubApi.UpdateGithubRepoVariable

Update a variable in a GitHub repository for actions workflows. Use this tool to update a specific variable in a GitHub repository that is used in GitHub Actions workflows. Authentication is required with an access token having `repo` scope or for GitHub Apps with `actions_variables:write` permission.

Parameters

ParameterTypeReq.Description
repository_namestringRequiredThe name of the repository. This is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This name is not case sensitive.
env_variable_namestringOptionalThe name of the variable to update in the GitHub repository.
repository_variable_valuestringOptionalThe new value for the specified repository variable.
variable_namestringOptionalThe name of the variable in the repository.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/update-repo-variable'.
#

GithubApi.UpdateGithubRepoWebhook

Update a webhook for a GitHub repository. This tool updates an existing webhook configured in a GitHub repository. It requires specifying the owner, repository, and hook ID. It is useful for changing webhook configurations or updating secrets. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the GitHub repository to update. It is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
webhook_unique_identifierintegerOptionalThe unique identifier of the webhook to be updated. It must be an integer. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/update-webhook'.
#

GithubApi.UpdateGithubRequiredWorkflow

Update a required workflow in a GitHub organization. This tool updates a specified required workflow within a GitHub organization. It requires an access token with `admin:org` scope for authentication.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
required_workflow_identifierintegerRequiredThe unique identifier for the required workflow to update in the organization.
repository_id_for_workflowstringOptionalThe ID of the repository containing the workflow file to be updated.
repository_ids_for_workflowarray<integer>OptionalList of repository IDs to enable the required workflow. Applicable only if `scope` is `selected`.
workflow_file_pathstringOptionalPath to the workflow file to be set as a required workflow in the organization.
workflow_scopestringOptionalSpecify the repository scope for enabling the workflow: 'all' for all repositories or 'selected' for specific ones within the organization.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/update-required-workflow'.
#

GithubApi.UpdateGithubTeam

Update a team's details within a GitHub organization. This tool allows modifying the details of a specific team within a GitHub organization. The authenticated user must be an organization owner or team maintainer to perform this action. It's intended for updating team information such as name or permissions.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. This is not case sensitive.
team_slugstringRequiredThe slug of the team name, used to uniquely identify the team within the organization.
parent_team_idintegerOptionalThe ID of the team to set as the parent team for nesting purposes.
team_descriptionstringOptionalThe description of the team. Provide a concise summary or details for team identification.
team_namestringOptionalThe new name for the GitHub team within the organization.
team_privacy_levelstringOptionalSpecifies the team's privacy level. Options: 'secret' (visible only to owners and team members) or 'closed' (visible to all organization members). Parent teams cannot be 'secret'.
team_repository_permissionstringOptional**Deprecated**. Specifies the default permission for newly added repositories. Options: 'pull', 'push', 'admin'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/update-in-org'.
#

GithubApi.UpdateGithubUsername

Update a GitHub user's username. Use this tool to change the username for a user in a GitHub enterprise environment.

Parameters

ParameterTypeReq.Description
current_github_usernamestringRequiredThe current handle of the GitHub user account to be updated.
new_github_usernamestringRequiredThe new username for the GitHub user account.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/update-username-for-user'.
#

GithubApi.UpdateGitReference

Update a Git reference in a GitHub repository. Use this tool to update a specific Git reference (e.g., a branch or tag) in a GitHub repository. Call this when you need to modify the target of a reference in a repo.

Parameters

ParameterTypeReq.Description
fully_qualified_reference_namestringRequiredThe fully qualified reference to update, e.g., `refs/heads/master`. Must start with `refs` and include at least two slashes.
repository_namestringRequiredThe name of the repository in GitHub. It is not case sensitive.
repository_ownerstringRequiredThe GitHub username or organization name that owns the repository. Not case sensitive.
target_sha1_valuestringRequiredThe SHA1 value to set the Git reference to. This should be a valid commit SHA in the repository.
force_updatebooleanOptionalSet to true to force the update and allow overwriting. False ensures a fast-forward update, preventing overwriting.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'git/update-ref'.
#

GithubApi.UpdateGlobalWebhook

Update a GitHub enterprise global webhook. Use this tool to modify settings of a global webhook in GitHub Enterprise. Parameters not provided will default or be removed if no default exists.

Parameters

ParameterTypeReq.Description
webhook_identifierintegerRequiredThe unique integer identifier for the webhook that needs to be updated.
hmac_secret_keystringOptionalSecret key for generating HMAC hex digest value in `X-Hub-Signature` header.
payload_delivery_urlstringOptionalThe URL where webhook payloads will be delivered for processing.
payload_media_typestringOptionalThe media type for payload serialization. Supported values: `json`, `form`. Default is `form`.
send_notifications_on_triggerbooleanOptionalSet to `true` to send notifications when the webhook is triggered.
verify_ssl_certificatestringOptionalDetermines SSL certificate verification for payload delivery. Use '0' for verification and '1' to skip (not recommended). Default is '0'.
webhook_trigger_eventsarray<string>OptionalThe events that trigger the global webhook. Can include 'user', 'organization'. Defaults to both if not specified.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/update-global-webhook'.
#

GithubApi.UpdateHookEnforcementForRepo

Update pre-receive hook enforcement for a GitHub repository. Use this tool to update the enforcement settings of a pre-receive hook configured at the repository level in GitHub. This tool allows adjusting the `enforcement` settings for specific repositories.

Parameters

ParameterTypeReq.Description
pre_receive_hook_idintegerRequiredThe unique identifier of the pre-receive hook to update enforcement settings for.
repository_namestringRequiredThe name of the repository. This is case insensitive and identifies which repository's hook enforcement settings to update.
repository_ownerstringRequiredThe GitHub account owner of the repository. This name is not case sensitive.
hook_enforcement_statestringOptionalThe desired state of enforcement for the hook on this repository. Options: 'enabled', 'disabled', 'testing'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/update-pre-receive-hook-enforcement-for-repo'.
#

GithubApi.UpdateLdapMappingForTeam

Update the LDAP mapping for a GitHub team. Use this tool to update the distinguished name (DN) of an LDAP entry mapped to a GitHub team. LDAP synchronization must be enabled for this operation.

Parameters

ParameterTypeReq.Description
ldap_distinguished_namestringRequiredThe distinguished name (DN) of the LDAP entry to map to a team. This should be a string following the LDAP DN format.
team_idintegerRequiredThe unique identifier of the GitHub team to update LDAP mapping for.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/update-ldap-mapping-for-team'.
#

GithubApi.UpdateLdapMappingForUser

Update LDAP mapping for a user in GitHub Enterprise Admin. This tool is used to update the LDAP mapping for a specific user in the GitHub Enterprise environment. It should be called when there's a need to modify or correct the LDAP information associated with a user's account.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe handle for the GitHub user account to update the LDAP mapping for.
ldap_distinguished_namestringRequiredThe distinguished name (DN) of the LDAP entry to map to a team. It should be in a string format as specified [here](https://www.ldap.com/ldap-dns-and-rdns).

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/update-ldap-mapping-for-user'.
#

GithubApi.UpdateOrCreateGithubFile

Create or update a file in a GitHub repository. This tool creates a new file or updates an existing one in a GitHub repository. It requires authentication with an access token having the `workflow` scope. Avoid using this tool concurrently with file deletion to prevent conflicts. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the GitHub repository, not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository. It is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
file_path_in_repositorystringOptionalThe file path within the repository where the file will be created or updated. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/create-or-update-file-contents'.
#

GithubApi.UpdateOrgMembership

Manage user membership for a GitHub organization. This tool allows authenticated organization owners on GitHub to add members to an organization or update their roles. It sends invitations to new members or modifies the roles of existing ones. Use this tool to manage user roles, either by inviting them or updating their status within the organization.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe handle for the GitHub user account to be added or updated in the organization.
organization_namestringRequiredThe name of the GitHub organization. It is not case sensitive.
user_role_in_organizationstringOptionalSpecify the user's role in the organization. Options are 'admin' for organization owner, or 'member' for non-owner.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/set-membership-for-user'.
#

GithubApi.UpdateOrgSecretRepos

Update repositories for an organization secret. Use this tool to replace all repositories associated with an organization secret when the repository access visibility is set to 'selected'. Authentication with an access token having the 'admin:org' scope or a GitHub App with the 'secrets' organization permission is required.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe organization's name for the secret. It is not case sensitive.
repository_ids_for_accessarray<integer>RequiredAn array of repository IDs allowed to access the organization secret when visibility is set to 'selected'.
secret_namestringRequiredThe name of the organization secret to update repositories for. This value is case-insensitive.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-selected-repos-for-org-secret'.
#

GithubApi.UpdateOrgWebhookConfig

Update webhook configuration for a GitHub organization. This tool updates the webhook configuration for a specific organization on GitHub. It should be called when you need to modify the webhook's settings, excluding "active" state and events. Requires `admin:org_hook` scope for tokens or `organization_hooks:write` permission for GitHub Apps. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
organization_namestringOptionalThe name of the GitHub organization to update. Case insensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
webhook_identifierintegerOptionalThe unique identifier of the webhook to be updated. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'orgs/update-webhook-config-for-org'.
#

GithubApi.UpdatePreReceiveHookEnforcement

Update pre-receive hook enforcement for a GitHub organization. This tool updates the enforcement settings and downstream configuration for pre-receive hooks at the organization level on GitHub. Call this tool to modify enforcement and downstream configuration for a specific pre-receive hook within an organization.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the GitHub organization. It's not case sensitive.
pre_receive_hook_idintegerRequiredThe unique identifier of the pre-receive hook to be updated.
allow_downstream_configurationbooleanOptionalBoolean indicating whether repositories can override the enforcement settings of the pre-receive hook.
enforcement_statestringOptionalSpecify the state of enforcement for the hook on this repository. Possible values may include 'enabled', 'disabled', etc.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/update-pre-receive-hook-enforcement-for-org'.
#

GithubApi.UpdateProjectBoard

Update a project board's information on GitHub. This tool updates the details of a specified project board on GitHub. It should be called when there is a need to modify the information of a project board. Note that a `404` error indicates projects are disabled, while a `401` or `410` error indicates insufficient privileges.

Parameters

ParameterTypeReq.Description
project_unique_identifierintegerRequiredThe unique identifier of the GitHub project board to update.
is_privatebooleanOptionalA boolean indicating if the project is private. Set to true for private (not visible to everyone) and false for public.
organization_permission_levelstringOptionalSets the baseline permission for all organization members on this project. Options are 'read', 'write', 'admin', or 'none'.
project_descriptionstringOptionalA detailed description or content of the project board.
project_namestringOptionalThe new name for the project board. Must be a string.
project_statestringOptionalSpecify the state of the project; use 'open' or 'closed'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/update'.
#

GithubApi.UpdateProjectColumn

Update an existing project column on GitHub. Use this tool to update details of an existing project column on GitHub. It's applicable when modifications to the project's column are needed, such as changing its name or settings.

Parameters

ParameterTypeReq.Description
column_identifierintegerRequiredThe unique identifier of the project column to update.
project_column_namestringRequiredThe new name for the project column on GitHub.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'projects/update-column'.
#

GithubApi.UpdateProvisionedEnterpriseUserInfo

Update all information for a provisioned enterprise user. This tool updates the information of an existing provisioned user in an enterprise account using the SCIM API. It requires all user information to be provided as if provisioning the user for the first time. Existing information not included will be removed. Use this for comprehensive updates, and not for partial attribute changes. Note: Setting 'active: false' will suspend the user. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
scim_user_identifierstringOptionalThe unique identifier of the SCIM user for updating their information. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/set-information-for-provisioned-enterprise-user'.
#

GithubApi.UpdatePullRequest

Update an existing pull request on GitHub. Use this tool to update an existing pull request in a GitHub repository. This can be used when you need to modify the details of a pull request, such as its title, body, or state. Requires write access to the source branch or membership in the owning organization.

Parameters

ParameterTypeReq.Description
pull_request_numberintegerRequiredThe unique number identifying the pull request.
repository_namestringRequiredThe name of the repository to update the pull request in. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. This name is not case sensitive.
maintainers_can_modifybooleanOptionalBoolean value indicating whether maintainers can modify the pull request.
pull_request_bodystringOptionalProvide the updated content or description for the pull request.
pull_request_statestringOptionalSpecifies whether the pull request should be 'open' or 'closed'.
pull_request_titlestringOptionalThe new title for the pull request. Use this to update the PR title.
target_base_branchstringOptionalThe name of the branch where changes should be pulled into. Must be an existing branch on the current repository.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/update'.
#

GithubApi.UpdatePullRequestBranch

Update a pull request branch with latest upstream changes. Use this tool to merge the latest changes from the base branch into a pull request branch, ensuring it is up-to-date with upstream changes.

Parameters

ParameterTypeReq.Description
pull_request_numberintegerRequiredThe unique number that identifies the pull request to update.
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
expected_head_shastringOptionalThe most recent commit SHA of the pull request's HEAD. Must match the pull request's current HEAD to avoid a 422 error.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/update-branch'.
#

GithubApi.UpdatePullRequestReview

Update the review summary comment on a pull request. Use this tool to change the content of a review summary comment for a specific pull request on GitHub. This is useful for revising feedback or updating information provided in the review.

Parameters

ParameterTypeReq.Description
pull_request_numberintegerRequiredThe unique number that identifies the pull request.
repository_namestringRequiredThe name of the repository to update the review on. Case insensitive.
repository_ownerstringRequiredThe GitHub account owner of the repository, case insensitive.
review_body_textstringRequiredThe updated body text for the pull request review.
review_identifierintegerRequiredThe unique integer ID of the review to be updated.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'pulls/update-review'.
#

GithubApi.UpdatePullRequestReviewProtection

Update pull request review protection settings for a branch. This tool allows updating the pull request review enforcement settings on a protected branch, requiring admin or owner permissions. It applies to branches in both public and private repositories with enabled branch protection settings. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_owner_namestringOptionalThe account owner of the repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository. This value is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
branch_namestringOptionalThe name of the branch to update. It must not contain wildcard characters. For wildcard support, use the GraphQL API. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/update-pull-request-review-protection'.
#

GithubApi.UpdateRepoActionsPermissions

Sets GitHub Actions permissions for a repository. Use this tool to set the GitHub Actions permissions policy for a specific repository. Ideal when you need to enable or restrict actions in a repository under certain conditions. Ensure to authenticate with a token having the `repo` scope or a GitHub App with `administration` permissions.

Parameters

ParameterTypeReq.Description
enable_github_actionsbooleanRequiredBoolean flag indicating if GitHub Actions should be enabled on the repository. `True` enables, `False` disables.
repository_namestringRequiredThe name of the repository. The name is not case sensitive.
repository_ownerstringRequiredThe account owner of the repository. The name is not case sensitive.
actions_permission_policystringOptionalDefines the policy for actions allowed to run: 'all', 'local_only', or 'selected'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-github-actions-permissions-repository'.
#

GithubApi.UpdateRepoInvitation

Update a repository invitation on GitHub. This tool updates the details of a repository invitation on GitHub. It should be called when you need to change the status or details of an invitation sent to a collaborator for a specific repository.

Parameters

ParameterTypeReq.Description
invitation_idintegerRequiredThe unique identifier of the invitation to be updated. It must be an integer.
repository_namestringRequiredThe name of the repository to update the invitation for. It is not case sensitive.
repository_ownerstringRequiredThe GitHub username of the account owner of the repository. It's not case sensitive.
user_permissionsstringOptionalSpecify the permission level for the user on the repository. Valid values are `read`, `write`, `maintain`, `triage`, and `admin`.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/update-invitation'.
#

GithubApi.UpdateRepoWebhookConfig

Update GitHub repository webhook configuration settings. This tool updates the webhook configuration for a specific GitHub repository. It is useful when you need to modify settings such as the payload URL, content type, or secret key of a webhook. Ensure you have appropriate permissions, such as the `write:repo_hook` or `repo` scope for access tokens, or `repository_hooks:write` for GitHub Apps. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
repository_ownerstringOptionalThe account owner of the repository. The name is not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
repository_namestringOptionalThe name of the repository. Not case sensitive. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
webhook_hook_idintegerOptionalThe unique identifier of the webhook to update in the repository. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'repos/update-webhook-config-for-repo'.
#

GithubApi.UpdateRunnerGroupEnterprise

Update the name and visibility of a self-hosted runner group in an enterprise. Use this tool to update the name and visibility settings of a self-hosted runner group within a GitHub enterprise. This requires authentication with a token that has the 'manage_runners:enterprise' scope.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID of the enterprise to identify which enterprise the runner group belongs to.
runner_group_idintegerRequiredUnique identifier of the self-hosted runner group to update.
allow_public_repositoriesbooleanOptionalSet to true if the runner group can be used by public repositories.
allowable_workflow_listarray<string>OptionalList of workflow names the runner group is allowed to run. Ignored unless `restricted_to_workflows` is set to `true`.
restrict_to_workflowsbooleanOptionalSet to true to restrict the runner group to only the workflows in the selected_workflows array.
runner_group_namestringOptionalName of the self-hosted runner group to be updated.
runner_group_visibilitystringOptionalSpecifies whether the runner group is visible to all organizations or only selected ones. Valid values are 'selected' or 'all'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/update-self-hosted-runner-group-for-enterprise'.
#

GithubApi.UpdateRunnerGroupSettings

Update name and visibility of a runner group in an organization. Call this tool to change the name or visibility of a self-hosted runner group within a GitHub organization. Requires authentication with an access token that has the `admin:org` scope.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. The name is not case sensitive.
runner_group_idintegerRequiredUnique identifier of the self-hosted runner group being updated.
runner_group_namestringRequiredThe new name for the self-hosted runner group in the organization.
allow_public_repository_usagebooleanOptionalSet to `true` to allow the runner group to be used by public repositories.
allowed_workflow_listarray<string>OptionalList of workflows the runner group can run. Ignored unless workflows are restricted.
restrict_runner_group_to_workflowsbooleanOptionalSet to `true` to restrict the runner group to running only the workflows specified in `selected_workflows`.
runner_group_visibilitystringOptionalSpecifies the visibility of the runner group. Options: 'selected' for individual repositories, 'all' for all repositories, 'private' for all private repositories.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/update-self-hosted-runner-group-for-org'.
#

GithubApi.UpdateSecretScanningAlertStatus

Update the status of a secret scanning alert on GitHub. Use this tool to update the status of a secret scanning alert in a GitHub repository. Requires admin access and a personal access token with the `repo`, `security_events`, or `public_repo` scopes, or a GitHub App with `secret_scanning_alerts` write permission.

Parameters

ParameterTypeReq.Description
alert_identifierintegerRequiredThe unique number identifying the secret scanning alert. Found in the alert URL or the response of `GET /repos/{owner}/{repo}/code-scanning/alerts`.
alert_statestringRequiredSet the state of the secret scanning alert to 'open' or 'resolved'. 'Resolution' is required if set to 'resolved'.
repository_namestringRequiredThe name of the repository. Not case sensitive.
repository_ownerstringRequiredThe GitHub username or organization name that owns the repository. It is not case sensitive.
alert_resolution_commentstringOptionalAn optional comment when closing an alert. Set to `null` if changing the alert state to `open`. Cannot be updated or deleted.
resolution_reason_for_secret_scanning_alertstringOptionalSpecifies the reason for resolving the alert when the state is set to 'resolved'. Possible values: 'None', 'false_positive', 'wont_fix', 'revoked', 'used_in_tests'.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'secret-scanning/update-alert'.
#

GithubApi.UpdateSecuritySettingsEnterprise

Update security and scanning settings for enterprise repositories. Use this tool to update the advanced security, secret scanning, and push protection settings for new repositories within an enterprise. Ensure you have admin access to the enterprise and an access token with the `admin:enterprise` scope.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug or ID of the enterprise. Accepts the enterprise's slug name or ID for identification.
enable_dependabot_alerts_for_new_repositoriesbooleanOptionalSet to true to automatically enable Dependabot alerts for new repositories.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'secret-scanning/patch-security-analysis-settings-for-enterprise'.
#

GithubApi.UpdateSelfHostedRunnersForOrgGroup

Update self-hosted runners in an organization's runner group. This tool allows you to replace the list of self-hosted runners in a specified organization runner group. It requires an access token with the 'admin:org' scope. Use this when you need to manage or update the runners assigned to a runner group in your organization.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. It is not case sensitive.
runner_group_idintegerRequiredUnique identifier for the self-hosted runner group to update.
runner_ids_to_addarray<integer>RequiredArray of integer IDs representing the runners to be added to the organization runner group.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'actions/set-self-hosted-runners-in-group-for-org'.
#

GithubApi.UpdateSelfHostedRunnersInGroup

Update self-hosted runners in an enterprise group. This tool replaces the list of self-hosted runners in a specified enterprise runner group. It requires authentication with an access token having the `manage_runners:enterprise` scope.

Parameters

ParameterTypeReq.Description
enterprise_identifierstringRequiredThe slug version of the enterprise name or the enterprise ID.
runner_group_identifierintegerRequiredUnique identifier for the self-hosted runner group. This integer ID specifies which group to update.
runner_ids_to_addarray<integer>RequiredArray of runner IDs to be added to the specified runner group in the enterprise. Each runner ID should be an integer.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'enterprise-admin/set-self-hosted-runners-in-group-for-enterprise'.
#

GithubApi.UpdateTeamDiscussion

Edits the title and body of a team discussion post. Use this tool to update the title and content of a discussion in a GitHub team within an organization. Only the specified fields will be changed. Requires OAuth tokens with `write:discussion` scope.

Parameters

ParameterTypeReq.Description
discussion_idintegerRequiredThe unique number identifying the discussion to be updated.
organization_namestringRequiredThe name of the organization. It is not case sensitive and uniquely identifies the organization on GitHub.
team_slugstringRequiredProvide the slug (URL-friendly version) of the team's name. Case sensitivity is ignored.
discussion_body_textstringOptionalThe updated body text of the discussion post. Provide the new content you want for the discussion.
discussion_titlestringOptionalThe new title for the discussion post. Only the provided title will be updated.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/update-discussion-in-org'.
#

GithubApi.UpdateTeamRepoPermissions

Manage team repository access and permissions. Use this tool to add a repository to a team or update a team's permission on a repository within an organization. The caller must have admin access and visibility of the team. The repository should be owned by the organization. Returns a confirmation of the action taken.

Parameters

ParameterTypeReq.Description
organization_namestringRequiredThe name of the organization. This parameter is not case sensitive.
repository_namestringRequiredThe name of the repository to be managed. The name is not case sensitive.
repository_owner_accountstringRequiredThe account owner of the repository. The name is not case sensitive.
team_slugstringRequiredThe slug identifier of the team within the organization. It is not case-sensitive.
team_repo_permissionstringOptionalPermission to grant the team on this repository. Options: `pull`, `triage`, `push`, `maintain`, `admin`, or a custom role name defined by the organization. Defaults to team's current permission if unspecified.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'teams/add-or-update-repo-permissions-in-org'.
#

GithubApi.UploadSarifCodeScanningResults

Upload SARIF data to GitHub for code scanning results. This tool uploads SARIF data from a code scanning analysis to a GitHub repository. Use appropriate access tokens for private or public repositories. Uploaded results appear in pull requests or the repository's security tab, depending on the reference used. SARIF data must be compressed and encoded before uploading.

Parameters

ParameterTypeReq.Description
base64_compressed_sarif_datastringRequiredA Base64-encoded string of the SARIF file compressed using gzip. Ensure proper encoding before upload.
commit_shastringRequiredThe SHA of the commit associated with the uploaded analysis. This links the SARIF data to a specific point in the repository's history.
git_referencestringRequiredThe full Git reference. Format: `refs/heads/<branch name>`, `refs/pull/<number>/merge`, or `refs/pull/<number>/head`.
repository_namestringRequiredThe name of the repository. It is not case sensitive and identifies where the SARIF data will be uploaded.
repository_ownerstringRequiredThe account owner of the repository on GitHub, not case sensitive.
analysis_start_timestringOptionalThe timestamp when the analysis run began, in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.
base_directory_for_analysisstringOptionalThe base directory used in the analysis as it appears in the SARIF file to map file paths correctly.
tool_namestringOptionalSpecifies the tool name used for generating the code scanning analysis. Defaults to 'API' if not provided. Supports filtering by tool GUID in alerts operations.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'code-scanning/upload-sarif'.
#

GithubApi.UserFollowingList

Retrieve users followed by a specified GitHub user. Call this tool to get a list of users that a specific GitHub user is following. It is useful for analyzing social connections or activity on GitHub.

Parameters

ParameterTypeReq.Description
github_user_handlestringRequiredThe GitHub username of the account whose followings you want to list.
result_page_numberintegerOptionalThe page number of the result set to retrieve. Use this to paginate results.
results_per_pageintegerOptionalSpecify the number of results to display per page. Maximum is 100.

Requirements

Secrets:GIT_SERVER_URL

Output

Type:jsonResponse from the API endpoint 'users/list-following-for-user'.
Last updated on