Skip to content

GitHub

Updated View as Markdown

Official GitHub REST API for repositories, issues, pull requests, actions, organizations and administration. Each command makes one request. Your token permissions and selected repositories determine access; write commands change real GitHub resources. Deprecated operations, non-JSON uploads and unsupported contracts are excluded from the catalog.

What you can do (1196)

What you can do

Available commands: 1196 (624 read, 572 write). Enable only the commands your application needs.

Command Effect
GitHub API Root — github.meta.root Read
List global security advisories — github.security-advisories.list-global-advisories Read
Get a global security advisory — github.security-advisories.get-global-advisory Read
List automations for user — github.agent-automations.list-automations Read
List automations for a repository — github.agent-automations.list-repo-automations Read
Create an automation for a repository — github.agent-automations.create-repo-automation Write
List available automation tools for a repository — github.agent-automations.list-available-repo-automation-tools Read
List available automation triggers for a repository — github.agent-automations.list-available-repo-automation-triggers Read
Get an automation — github.agent-automations.get-repo-automation Read
Update an automation — github.agent-automations.edit-repo-automation Write
Delete an automation — github.agent-automations.delete-repo-automation Write
List tasks for an automation in a repository — github.agent-automations.list-repo-automation-tasks Read
Run an automation — github.agent-automations.create-repo-automation-task Write
Get Agent Merge configuration for a pull request — github.agent-merge.get-agent-merge-enrollment Read
Update Agent Merge configuration for a pull request — github.agent-merge.put-agent-merge-enrollment Write
Disable Agent Merge for a pull request — github.agent-merge.delete-agent-merge-enrollment Write
List tasks for repository — github.agent-tasks.list-tasks-for-repo Read
Start a task — github.agent-tasks.create-task-in-repo Write
Get a task by repo — github.agent-tasks.get-task-by-repo-and-id Read
List tasks — github.agent-tasks.list-tasks Read
Get a task by ID — github.agent-tasks.get-task-by-id Read
Get the authenticated app — github.apps.get-authenticated Read
Create a GitHub App from a manifest — github.apps.create-from-manifest Write
Get a webhook configuration for an app — github.apps.get-webhook-config-for-app Read
Update a webhook configuration for an app — github.apps.update-webhook-config-for-app Write
List deliveries for an app webhook — github.apps.list-webhook-deliveries Read
Get a delivery for an app webhook — github.apps.get-webhook-delivery Read
Redeliver a delivery for an app webhook — github.apps.redeliver-webhook-delivery Write
List installation requests for the authenticated app — github.apps.list-installation-requests-for-authenticated-app Read
List installations for the authenticated app — github.apps.list-installations Read
Get an installation for the authenticated app — github.apps.get-installation Read
Delete an installation for the authenticated app — github.apps.delete-installation Write
Create an installation access token for an app — github.apps.create-installation-access-token Write
Suspend an app installation — github.apps.suspend-installation Write
Unsuspend an app installation — github.apps.unsuspend-installation Write
Delete an app authorization — github.apps.delete-authorization Write
Check a token — github.apps.check-token Write
Reset a token — github.apps.reset-token Write
Delete an app token — github.apps.delete-token Write
Create a scoped access token — github.apps.scope-token Write
Get an app — github.apps.get-by-slug Read
Get all codes of conduct — github.codes-of-conduct.get-all-codes-of-conduct Read
Get a code of conduct — github.codes-of-conduct.get-conduct-code Read
Revoke a list of credentials — github.credentials.revoke Write
Get emojis — github.emojis.get Read
Get GitHub Actions cache retention limit for an enterprise — github.actions.get-actions-cache-retention-limit-for-enterprise Read
Set GitHub Actions cache retention limit for an enterprise — github.actions.set-actions-cache-retention-limit-for-enterprise Write
Get GitHub Actions cache storage limit for an enterprise — github.actions.get-actions-cache-storage-limit-for-enterprise Read
Set GitHub Actions cache storage limit for an enterprise — github.actions.set-actions-cache-storage-limit-for-enterprise Write
List OIDC custom property inclusions for an enterprise — github.oidc.list-oidc-custom-property-inclusions-for-enterprise Read
Create an OIDC custom property inclusion for an enterprise — github.oidc.create-oidc-custom-property-inclusion-for-enterprise Write
Delete an OIDC custom property inclusion for an enterprise — github.oidc.delete-oidc-custom-property-inclusion-for-enterprise Write
Get code security configurations for an enterprise — github.code-security.get-configurations-for-enterprise Read
Create a code security configuration for an enterprise — github.code-security.create-configuration-for-enterprise Write
Get default code security configurations for an enterprise — github.code-security.get-default-configurations-for-enterprise Read
Retrieve a code security configuration of an enterprise — github.code-security.get-single-configuration-for-enterprise Read
Update a custom code security configuration for an enterprise — github.code-security.update-enterprise-configuration Write
Delete a code security configuration for an enterprise — github.code-security.delete-configuration-for-enterprise Write
Attach an enterprise configuration to repositories — github.code-security.attach-enterprise-configuration Write
Set a code security configuration as a default for an enterprise — github.code-security.set-configuration-as-default-for-enterprise Write
Get repositories associated with an enterprise code security configuration — github.code-security.get-repositories-for-enterprise-configuration Read
Get Copilot enterprise usage metrics for a specific day — github.copilot.copilot-enterprise-one-day-usage-metrics Read
Get Copilot enterprise usage metrics — github.copilot.copilot-enterprise-usage-metrics Read
Get Copilot enterprise repository report for a specific day — github.copilot.copilot-enterprise-repos-one-day-report Read
Get Copilot enterprise user-teams report for a specific day — github.copilot.copilot-enterprise-user-teams-one-day-report Read
Get Copilot users usage metrics for a specific day — github.copilot.copilot-users-one-day-usage-metrics Read
Get Copilot users usage metrics — github.copilot.copilot-users-usage-metrics Read
Set the coding agent policy for an enterprise — github.copilot.set-enterprise-coding-agent-policy Write
Add organizations to the enterprise coding agent policy — github.copilot.add-organizations-to-enterprise-coding-agent-policy Write
Remove organizations from the enterprise coding agent policy — github.copilot.remove-organizations-from-enterprise-coding-agent-policy Write
List Dependabot alerts for an enterprise — github.dependabot.list-alerts-for-enterprise Read
Lists the repositories Dependabot can access in an enterprise — github.dependabot.repository-access-for-enterprise Read
Updates Dependabot's repository access list for an enterprise — github.dependabot.update-repository-access-for-enterprise Write
Set the default repository access level for Dependabot in an enterprise — github.dependabot.set-repository-access-default-level-for-enterprise Write
List public events — github.activity.list-public-events Read
Get feeds — github.activity.get-feeds Read
List gists for the authenticated user — github.gists.list Read
Create a gist — github.gists.create Write
List public gists — github.gists.list-public Read
List starred gists — github.gists.list-starred Read
Get a gist — github.gists.get Read
Update a gist — github.gists.update Write
Delete a gist — github.gists.delete Write
List gist comments — github.gists.list-comments Read
Create a gist comment — github.gists.create-comment Write
Get a gist comment — github.gists.get-comment Read
Update a gist comment — github.gists.update-comment Write
Delete a gist comment — github.gists.delete-comment Write
List gist commits — github.gists.list-commits Read
List gist forks — github.gists.list-forks Read
Fork a gist — github.gists.fork Write
Check if a gist is starred — github.gists.check-is-starred Read
Star a gist — github.gists.star Write
Unstar a gist — github.gists.unstar Write
Get a gist revision — github.gists.get-revision Read
Get all gitignore templates — github.gitignore.get-all-templates Read
Get a gitignore template — github.gitignore.get-template Read
List repositories accessible to the app installation — github.apps.list-repos-accessible-to-installation Read
Revoke an installation access token — github.apps.revoke-installation-access-token Write
List issues assigned to the authenticated user — github.issues.list Read
Get all commonly used licenses — github.licenses.get-all-commonly-used Read
Get a license — github.licenses.get Read
Render a Markdown document — github.markdown.render Write
Get a subscription plan for an account — github.apps.get-subscription-plan-for-account Read
List plans — github.apps.list-plans Read
List accounts for a plan — github.apps.list-accounts-for-plan Read
Get a subscription plan for an account (stubbed) — github.apps.get-subscription-plan-for-account-stubbed Read
List plans (stubbed) — github.apps.list-plans-stubbed Read
List accounts for a plan (stubbed) — github.apps.list-accounts-for-plan-stubbed Read
Get GitHub meta information — github.meta.get Read
List public events for a network of repositories — github.activity.list-public-events-for-repo-network Read
List notifications for the authenticated user — github.activity.list-notifications-for-authenticated-user Read
Mark notifications as read — github.activity.mark-notifications-as-read Write
Get a thread — github.activity.get-thread Read
Mark a thread as read — github.activity.mark-thread-as-read Write
Mark a thread as done — github.activity.mark-thread-as-done Write
Get a thread subscription for the authenticated user — github.activity.get-thread-subscription-for-authenticated-user Read
Set a thread subscription — github.activity.set-thread-subscription Write
Delete a thread subscription — github.activity.delete-thread-subscription Write
Get Octocat — github.meta.get-octocat Read
List organizations — github.orgs.list Read
Get GitHub Actions cache retention limit for an organization — github.actions.get-actions-cache-retention-limit-for-organization Read
Set GitHub Actions cache retention limit for an organization — github.actions.set-actions-cache-retention-limit-for-organization Write
Get GitHub Actions cache storage limit for an organization — github.actions.get-actions-cache-storage-limit-for-organization Read
Set GitHub Actions cache storage limit for an organization — github.actions.set-actions-cache-storage-limit-for-organization Write
Get billing AI credit usage report for an organization — github.billing.get-github-billing-ai-credit-usage-report-org Read
Get all budgets for an organization — github.billing.get-all-budgets-org Read
Create a budget for an organization — github.billing.create-organization-budget Write
Get a budget by ID for an organization — github.billing.get-budget-org Read
Update a budget for an organization — github.billing.update-budget-org Write
Delete a budget for an organization — github.billing.delete-budget-org Write
Get billing premium request usage report for an organization — github.billing.get-github-billing-premium-request-usage-report-org Read
Get billing usage report for an organization — github.billing.get-github-billing-usage-report-org Read
Get billing usage summary for an organization — github.billing.get-github-billing-usage-summary-report-org Read
Get an organization — github.orgs.get Read
Update an organization — github.orgs.update Write
Delete an organization — github.orgs.delete Write
Get GitHub Actions cache usage for an organization — github.actions.get-actions-cache-usage-for-org Read
List repositories with GitHub Actions cache usage for an organization — github.actions.get-actions-cache-usage-by-repo-for-org Read
List GitHub-hosted runners for an organization — github.actions.list-hosted-runners-for-org Read
Create a GitHub-hosted runner for an organization — github.actions.create-hosted-runner-for-org Write
List custom images for an organization — github.actions.list-custom-images-for-org Read
Get a custom image definition for GitHub Actions Hosted Runners — github.actions.get-custom-image-for-org Read
Delete a custom image from the organization — github.actions.delete-custom-image-from-org Write
List image versions of a custom image for an organization — github.actions.list-custom-image-versions-for-org Read
Get GitHub-owned images for GitHub-hosted runners in an organization — github.actions.get-hosted-runners-github-owned-images-for-org Read
Get partner images for GitHub-hosted runners in an organization — github.actions.get-hosted-runners-partner-images-for-org Read
Get limits on GitHub-hosted runners for an organization — github.actions.get-hosted-runners-limits-for-org Read
Get GitHub-hosted runners machine specs for an organization — github.actions.get-hosted-runners-machine-specs-for-org Read
Get platforms for GitHub-hosted runners in an organization — github.actions.get-hosted-runners-platforms-for-org Read
Get a GitHub-hosted runner for an organization — github.actions.get-hosted-runner-for-org Read
Update a GitHub-hosted runner for an organization — github.actions.update-hosted-runner-for-org Write
Delete a GitHub-hosted runner for an organization — github.actions.delete-hosted-runner-for-org Write
List OIDC custom property inclusions for an organization — github.oidc.list-oidc-custom-property-inclusions-for-org Read
Create an OIDC custom property inclusion for an organization — github.oidc.create-oidc-custom-property-inclusion-for-org Write
Delete an OIDC custom property inclusion for an organization — github.oidc.delete-oidc-custom-property-inclusion-for-org Write
Get the customization template for an OIDC subject claim for an organization — github.oidc.get-oidc-custom-sub-template-for-org Read
Set the customization template for an OIDC subject claim for an organization — github.oidc.update-oidc-custom-sub-template-for-org Write
Get GitHub Actions permissions for an organization — github.actions.get-github-actions-permissions-organization Read
Set GitHub Actions permissions for an organization — github.actions.set-github-actions-permissions-organization Write
Get artifact and log retention settings for an organization — github.actions.get-artifact-and-log-retention-settings-organization Read
Set artifact and log retention settings for an organization — github.actions.set-artifact-and-log-retention-settings-organization Write
Get fork PR contributor approval permissions for an organization — github.actions.get-fork-pr-contributor-approval-permissions-organization Read
Set fork PR contributor approval permissions for an organization — github.actions.set-fork-pr-contributor-approval-permissions-organization Write
Get private repo fork PR workflow settings for an organization — github.actions.get-private-repo-fork-pr-workflows-settings-organization Read
Set private repo fork PR workflow settings for an organization — github.actions.set-private-repo-fork-pr-workflows-settings-organization Write
List selected repositories enabled for GitHub Actions in an organization — github.actions.list-selected-repositories-enabled-github-actions-organization Read
Set selected repositories enabled for GitHub Actions in an organization — github.actions.set-selected-repositories-enabled-github-actions-organization Write
Enable a selected repository for GitHub Actions in an organization — github.actions.enable-selected-repository-github-actions-organization Write
Disable a selected repository for GitHub Actions in an organization — github.actions.disable-selected-repository-github-actions-organization Write
Get allowed actions and reusable workflows for an organization — github.actions.get-allowed-actions-organization Read
Set allowed actions and reusable workflows for an organization — github.actions.set-allowed-actions-organization Write
Get self-hosted runners settings for an organization — github.actions.get-self-hosted-runners-permissions-organization Read
Set self-hosted runners settings for an organization — github.actions.set-self-hosted-runners-permissions-organization Write
List repositories allowed to use self-hosted runners in an organization — github.actions.list-selected-repositories-self-hosted-runners-organization Read
Set repositories allowed to use self-hosted runners in an organization — github.actions.set-selected-repositories-self-hosted-runners-organization Write
Add a repository to the list of repositories allowed to use self-hosted runners in an organization — github.actions.enable-selected-repository-self-hosted-runners-organization Write
Remove a repository from the list of repositories allowed to use self-hosted runners in an organization — github.actions.disable-selected-repository-self-hosted-runners-organization Write
Get default workflow permissions for an organization — github.actions.get-github-actions-default-workflow-permissions-organization Read
Set default workflow permissions for an organization — github.actions.set-github-actions-default-workflow-permissions-organization Write
List organization Actions policies — github.actions.get-org-actions-policies Read
Create an organization Actions policy — github.actions.create-org-actions-policy Write
Get an organization Actions policy — github.actions.get-org-actions-policy Read
Update an organization Actions policy — github.actions.update-org-actions-policy Write
Delete an organization Actions policy — github.actions.delete-org-actions-policy Write
List self-hosted runner groups for an organization — github.actions.list-self-hosted-runner-groups-for-org Read
Create a self-hosted runner group for an organization — github.actions.create-self-hosted-runner-group-for-org Write
Get a self-hosted runner group for an organization — github.actions.get-self-hosted-runner-group-for-org Read
Update a self-hosted runner group for an organization — github.actions.update-self-hosted-runner-group-for-org Write
Delete a self-hosted runner group from an organization — github.actions.delete-self-hosted-runner-group-from-org Write
List GitHub-hosted runners in a group for an organization — github.actions.list-github-hosted-runners-in-group-for-org Read
List repository access to a self-hosted runner group in an organization — github.actions.list-repo-access-to-self-hosted-runner-group-in-org Read
Set repository access for a self-hosted runner group in an organization — github.actions.set-repo-access-to-self-hosted-runner-group-in-org Write
Add repository access to a self-hosted runner group in an organization — github.actions.add-repo-access-to-self-hosted-runner-group-in-org Write
Remove repository access to a self-hosted runner group in an organization — github.actions.remove-repo-access-to-self-hosted-runner-group-in-org Write
List self-hosted runners in a group for an organization — github.actions.list-self-hosted-runners-in-group-for-org Read
Set self-hosted runners in a group for an organization — github.actions.set-self-hosted-runners-in-group-for-org Write
Add a self-hosted runner to a group for an organization — github.actions.add-self-hosted-runner-to-group-for-org Write
Remove a self-hosted runner from a group for an organization — github.actions.remove-self-hosted-runner-from-group-for-org Write
List self-hosted runners for an organization — github.actions.list-self-hosted-runners-for-org Read
Get runner version end-of-life schedule for an organization — github.actions.get-runner-version-deprecation-for-org Read
List runner applications for an organization — github.actions.list-runner-applications-for-org Read
Create configuration for a just-in-time runner for an organization — github.actions.generate-runner-jitconfig-for-org Write
Create a registration token for an organization — github.actions.create-registration-token-for-org Write
Create a remove token for an organization — github.actions.create-remove-token-for-org Write
Get a self-hosted runner for an organization — github.actions.get-self-hosted-runner-for-org Read
Delete a self-hosted runner from an organization — github.actions.delete-self-hosted-runner-from-org Write
List labels for a self-hosted runner for an organization — github.actions.list-labels-for-self-hosted-runner-for-org Read
Add custom labels to a self-hosted runner for an organization — github.actions.add-custom-labels-to-self-hosted-runner-for-org Write
Set custom labels for a self-hosted runner for an organization — github.actions.set-custom-labels-for-self-hosted-runner-for-org Write
Remove all custom labels from a self-hosted runner for an organization — github.actions.remove-all-custom-labels-from-self-hosted-runner-for-org Write
Remove a custom label from a self-hosted runner for an organization — github.actions.remove-custom-label-from-self-hosted-runner-for-org Write
List organization secrets — github.actions.list-org-secrets Read
Get an organization public key — github.actions.get-org-public-key Read
Get an organization secret — github.actions.get-org-secret Read
Create or update an organization secret — github.actions.create-or-update-org-secret Write
Delete an organization secret — github.actions.delete-org-secret Write
List selected repositories for an organization secret — github.actions.list-selected-repos-for-org-secret Read
Set selected repositories for an organization secret — github.actions.set-selected-repos-for-org-secret Write
Add selected repository to an organization secret — github.actions.add-selected-repo-to-org-secret Write
Remove selected repository from an organization secret — github.actions.remove-selected-repo-from-org-secret Write
List organization variables — github.actions.list-org-variables Read
Create an organization variable — github.actions.create-org-variable Write
Get an organization variable — github.actions.get-org-variable Read
Update an organization variable — github.actions.update-org-variable Write
Delete an organization variable — github.actions.delete-org-variable Write
List selected repositories for an organization variable — github.actions.list-selected-repos-for-org-variable Read
Set selected repositories for an organization variable — github.actions.set-selected-repos-for-org-variable Write
Add selected repository to an organization variable — github.actions.add-selected-repo-to-org-variable Write
Remove selected repository from an organization variable — github.actions.remove-selected-repo-from-org-variable Write
List organization secrets — github.agents.list-org-secrets Read
Get an organization public key — github.agents.get-org-public-key Read
Get an organization secret — github.agents.get-org-secret Read
Create or update an organization secret — github.agents.create-or-update-org-secret Write
Delete an organization secret — github.agents.delete-org-secret Write
List selected repositories for an organization secret — github.agents.list-selected-repos-for-org-secret Read
Set selected repositories for an organization secret — github.agents.set-selected-repos-for-org-secret Write
Add selected repository to an organization secret — github.agents.add-selected-repo-to-org-secret Write
Remove selected repository from an organization secret — github.agents.remove-selected-repo-from-org-secret Write
List organization variables — github.agents.list-org-variables Read
Create an organization variable — github.agents.create-org-variable Write
Get an organization variable — github.agents.get-org-variable Read
Update an organization variable — github.agents.update-org-variable Write
Delete an organization variable — github.agents.delete-org-variable Write
List selected repositories for an organization variable — github.agents.list-selected-repos-for-org-variable Read
Set selected repositories for an organization variable — github.agents.set-selected-repos-for-org-variable Write
Add selected repository to an organization variable — github.agents.add-selected-repo-to-org-variable Write
Remove selected repository from an organization variable — github.agents.remove-selected-repo-from-org-variable Write
Create an artifact deployment record — github.orgs.create-artifact-deployment-record Write
Set cluster deployment records — github.orgs.set-cluster-deployment-records Write
Create a cluster deployment records job — github.orgs.create-cluster-deployment-records-job Write
Get cluster deployment records job status — github.orgs.get-cluster-deployment-records-job Read
Create artifact metadata storage record — github.orgs.create-artifact-storage-record Write
List artifact storage records — github.orgs.list-artifact-storage-records Read
List attestations by bulk subject digests — github.orgs.list-attestations-bulk Write
Delete attestations in bulk — github.orgs.delete-attestations-bulk Write
Delete attestations by subject digest — github.orgs.delete-attestations-by-subject-digest Write
List attestation repositories — github.orgs.list-attestation-repositories Read
Delete attestations by ID — github.orgs.delete-attestations-by-id Write
List attestations — github.orgs.list-attestations Read
List users blocked by an organization — github.orgs.list-blocked-users Read
Check if a user is blocked by an organization — github.orgs.check-blocked-user Read
Block a user from an organization — github.orgs.block-user Write
Unblock a user from an organization — github.orgs.unblock-user Write
List campaigns for an organization — github.campaigns.list-org-campaigns Read
Create a campaign for an organization — github.campaigns.create-campaign Write
Get a campaign for an organization — github.campaigns.get-campaign-summary Read
Update a campaign — github.campaigns.update-campaign Write
Delete a campaign for an organization — github.campaigns.delete-campaign Write
Get the AI Scan setting for an organization — github.code-scanning.get-ai-scan-enablement-for-org Read
List code scanning alerts for an organization — github.code-scanning.list-alerts-for-org Read
Get code security configurations for an organization — github.code-security.get-configurations-for-org Read
Create a code security configuration — github.code-security.create-configuration Write
Get default code security configurations — github.code-security.get-default-configurations Read
Detach configurations from repositories — github.code-security.detach-configuration Write
Get a code security configuration — github.code-security.get-configuration Read
Update a code security configuration — github.code-security.update-configuration Write
Delete a code security configuration — github.code-security.delete-configuration Write
Attach a configuration to repositories — github.code-security.attach-configuration Write
Set a code security configuration as a default for an organization — github.code-security.set-configuration-as-default Write
Get repositories associated with a code security configuration — github.code-security.get-repositories-for-configuration Read
List codespaces for the organization — github.codespaces.list-in-organization Read
List organization secrets — github.codespaces.list-org-secrets Read
Get an organization public key — github.codespaces.get-org-public-key Read
Get an organization secret — github.codespaces.get-org-secret Read
Create or update an organization secret — github.codespaces.create-or-update-org-secret Write
Delete an organization secret — github.codespaces.delete-org-secret Write
List selected repositories for an organization secret — github.codespaces.list-selected-repos-for-org-secret Read
Set selected repositories for an organization secret — github.codespaces.set-selected-repos-for-org-secret Write
Add selected repository to an organization secret — github.codespaces.add-selected-repo-to-org-secret Write
Remove selected repository from an organization secret — github.codespaces.remove-selected-repo-from-org-secret Write
List organization Copilot Spaces — github.copilot-spaces.list-for-org Read
Create an organization Copilot Space — github.copilot-spaces.create-for-org Write
Get an organization Copilot Space — github.copilot-spaces.get-for-org Read
Set an organization Copilot Space — github.copilot-spaces.update-for-org Write
Delete an organization Copilot Space — github.copilot-spaces.delete-for-org Write
List collaborators for an organization Copilot Space — github.copilot-spaces.list-collaborators-for-org Read
Add a collaborator to an organization Copilot Space — github.copilot-spaces.add-collaborator-for-org Write
Set a collaborator role for an organization Copilot Space — github.copilot-spaces.update-collaborator-for-org Write
Remove a collaborator from an organization Copilot Space — github.copilot-spaces.remove-collaborator-for-org Write
List resources for an organization Copilot Space — github.copilot-spaces.list-resources-for-org Read
Create a resource for an organization Copilot Space — github.copilot-spaces.create-resource-for-org Write
Get a resource for an organization Copilot Space — github.copilot-spaces.get-resource-for-org Read
Set a resource for an organization Copilot Space — github.copilot-spaces.update-resource-for-org Write
Delete a resource from an organization Copilot Space — github.copilot-spaces.delete-resource-for-org Write
Get Copilot seat information and settings for an organization — github.copilot.get-copilot-organization-details Read
List all Copilot seat assignments for an organization — github.copilot.list-copilot-seats Read
Add teams to the Copilot subscription for an organization — github.copilot.add-copilot-seats-for-teams Write
Remove teams from the Copilot subscription for an organization — github.copilot.cancel-copilot-seat-assignment-for-teams Write
Add users to the Copilot subscription for an organization — github.copilot.add-copilot-seats-for-users Write
Remove users from the Copilot subscription for an organization — github.copilot.cancel-copilot-seat-assignment-for-users Write
Get Copilot cloud agent permissions for an organization — github.copilot.get-copilot-coding-agent-permissions-organization Read
Set Copilot cloud agent permissions for an organization — github.copilot.set-copilot-coding-agent-permissions-organization Write
List repositories enabled for Copilot cloud agent in an organization — github.copilot.list-copilot-coding-agent-selected-repositories-for-organization Read
Set selected repositories for Copilot cloud agent in an organization — github.copilot.set-copilot-coding-agent-selected-repositories-for-organization Write
Enable a repository for Copilot cloud agent in an organization — github.copilot.enable-copilot-coding-agent-for-repository-in-organization Write
Disable a repository for Copilot cloud agent in an organization — github.copilot.disable-copilot-coding-agent-for-repository-in-organization Write
Get Copilot content exclusion rules for an organization — github.copilot.copilot-content-exclusion-for-organization Read
Set Copilot content exclusion rules for an organization — github.copilot.set-copilot-content-exclusion-for-organization Write
Get Copilot organization usage metrics for a specific day — github.copilot.copilot-organization-one-day-usage-metrics Read
Get Copilot organization usage metrics — github.copilot.copilot-organization-usage-metrics Read
Get Copilot organization repository report for a specific day — github.copilot.copilot-organization-repos-one-day-report Read
Get Copilot organization user-teams report for a specific day — github.copilot.copilot-organization-user-teams-one-day-report Read
Get Copilot organization users usage metrics for a specific day — github.copilot.copilot-organization-users-one-day-usage-metrics Read
Get Copilot organization users usage metrics — github.copilot.copilot-organization-users-usage-metrics Read
List Dependabot alerts for an organization — github.dependabot.list-alerts-for-org Read
Lists the repositories Dependabot can access in an organization — github.dependabot.repository-access-for-org Read
Updates Dependabot's repository access list for an organization — github.dependabot.update-repository-access-for-org Write
Set the default repository access level for Dependabot — github.dependabot.set-repository-access-default-level Write
List organization secrets — github.dependabot.list-org-secrets Read
Get an organization public key — github.dependabot.get-org-public-key Read
Get an organization secret — github.dependabot.get-org-secret Read
Create or update an organization secret — github.dependabot.create-or-update-org-secret Write
Delete an organization secret — github.dependabot.delete-org-secret Write
List selected repositories for an organization secret — github.dependabot.list-selected-repos-for-org-secret Read
Set selected repositories for an organization secret — github.dependabot.set-selected-repos-for-org-secret Write
Add selected repository to an organization secret — github.dependabot.add-selected-repo-to-org-secret Write
Remove selected repository from an organization secret — github.dependabot.remove-selected-repo-from-org-secret Write
Get list of conflicting packages during Docker migration for organization — github.packages.list-docker-migration-conflicting-packages-for-organization Read
List public organization events — github.activity.list-public-org-events Read
List failed organization invitations — github.orgs.list-failed-invitations Read
List organization webhooks — github.orgs.list-webhooks Read
Create an organization webhook — github.orgs.create-webhook Write
Get an organization webhook — github.orgs.get-webhook Read
Update an organization webhook — github.orgs.update-webhook Write
Delete an organization webhook — github.orgs.delete-webhook Write
Get a webhook configuration for an organization — github.orgs.get-webhook-config-for-org Read
Update a webhook configuration for an organization — github.orgs.update-webhook-config-for-org Write
List deliveries for an organization webhook — github.orgs.list-webhook-deliveries Read
Get a webhook delivery for an organization webhook — github.orgs.get-webhook-delivery Read
Redeliver a delivery for an organization webhook — github.orgs.redeliver-webhook-delivery Write
Ping an organization webhook — github.orgs.ping-webhook Write
Get route stats by actor — github.api-insights.get-route-stats-by-actor Read
Get subject stats — github.api-insights.get-subject-stats Read
Get summary stats — github.api-insights.get-summary-stats Read
Get summary stats by user — github.api-insights.get-summary-stats-by-user Read
Get summary stats by actor — github.api-insights.get-summary-stats-by-actor Read
Get time stats — github.api-insights.get-time-stats Read
Get time stats by user — github.api-insights.get-time-stats-by-user Read
Get time stats by actor — github.api-insights.get-time-stats-by-actor Read
Get user stats — github.api-insights.get-user-stats Read
Get an organization installation for the authenticated app — github.apps.get-org-installation Read
List app installations for an organization — github.orgs.list-app-installations Read
Get interaction restrictions for an organization — github.interactions.get-restrictions-for-org Read
Set interaction restrictions for an organization — github.interactions.set-restrictions-for-org Write
Remove interaction restrictions for an organization — github.interactions.remove-restrictions-for-org Write
Get pull request creation cap for an org — github.interactions.get-pull-request-creation-cap-for-org Read
Update pull request creation cap for an org — github.interactions.update-pull-request-creation-cap-for-org Write
List pending organization invitations — github.orgs.list-pending-invitations Read
Create an organization invitation — github.orgs.create-invitation Write
Cancel an organization invitation — github.orgs.cancel-invitation Write
List organization invitation teams — github.orgs.list-invitation-teams Read
List issue fields for an organization — github.orgs.list-issue-fields Read
Create issue field for an organization — github.orgs.create-issue-field Write
Update issue field for an organization — github.orgs.update-issue-field Write
Delete issue field for an organization — github.orgs.delete-issue-field Write
List issue types for an organization — github.orgs.list-issue-types Read
Create issue type for an organization — github.orgs.create-issue-type Write
Update issue type for an organization — github.orgs.update-issue-type Write
Delete issue type for an organization — github.orgs.delete-issue-type Write
List organization issues assigned to the authenticated user — github.issues.list-for-org Read
List organization members — github.orgs.list-members Read
Check organization membership for a user — github.orgs.check-membership-for-user Read
Remove an organization member — github.orgs.remove-member Write
List codespaces for a user in organization — github.codespaces.get-codespaces-for-user-in-org Read
Delete a codespace from the organization — github.codespaces.delete-from-organization Write
Stop a codespace for an organization user — github.codespaces.stop-in-organization Write
Get Copilot seat assignment details for a user — github.copilot.get-copilot-seat-details-for-user Read
Get organization membership for a user — github.orgs.get-membership-for-user Read
Set organization membership for a user — github.orgs.set-membership-for-user Write
Remove organization membership for a user — github.orgs.remove-membership-for-user Write
List organization migrations — github.migrations.list-for-org Read
Start an organization migration — github.migrations.start-for-org Write
Get an organization migration status — github.migrations.get-status-for-org Read
Delete an organization migration archive — github.migrations.delete-archive-for-org Write
Unlock an organization repository — github.migrations.unlock-repo-for-org Write
List repositories in an organization migration — github.migrations.list-repos-for-org Read
Get all organization roles for an organization — github.orgs.list-org-roles Read
Remove all organization roles for a team — github.orgs.revoke-all-org-roles-team Write
Assign an organization role to a team — github.orgs.assign-team-to-org-role Write
Remove an organization role from a team — github.orgs.revoke-org-role-team Write
Remove all organization roles for a user — github.orgs.revoke-all-org-roles-user Write
Assign an organization role to a user — github.orgs.assign-user-to-org-role Write
Remove an organization role from a user — github.orgs.revoke-org-role-user Write
Get an organization role — github.orgs.get-org-role Read
List teams that are assigned to an organization role — github.orgs.list-org-role-teams Read
List users that are assigned to an organization role — github.orgs.list-org-role-users Read
List outside collaborators for an organization — github.orgs.list-outside-collaborators Read
Convert an organization member to outside collaborator — github.orgs.convert-member-to-outside-collaborator Write
Remove outside collaborator from an organization — github.orgs.remove-outside-collaborator Write
List packages for an organization — github.packages.list-packages-for-organization Read
Get a package for an organization — github.packages.get-package-for-organization Read
Delete a package for an organization — github.packages.delete-package-for-org Write
Restore a package for an organization — github.packages.restore-package-for-org Write
List package versions for a package owned by an organization — github.packages.get-all-package-versions-for-package-owned-by-org Read
Get a package version for an organization — github.packages.get-package-version-for-organization Read
Delete package version for an organization — github.packages.delete-package-version-for-org Write
Restore package version for an organization — github.packages.restore-package-version-for-org Write
List requests to access organization resources with fine-grained personal access tokens — github.orgs.list-pat-grant-requests Read
Review requests to access organization resources with fine-grained personal access tokens — github.orgs.review-pat-grant-requests-in-bulk Write
Review a request to access organization resources with a fine-grained personal access token — github.orgs.review-pat-grant-request Write
List repositories requested to be accessed by a fine-grained personal access token — github.orgs.list-pat-grant-request-repositories Read
List fine-grained personal access tokens with access to organization resources — github.orgs.list-pat-grants Read
Update the access to organization resources via fine-grained personal access tokens — github.orgs.update-pat-accesses Write
Update the access a fine-grained personal access token has to organization resources — github.orgs.update-pat-access Write
List repositories a fine-grained personal access token has access to — github.orgs.list-pat-grant-repositories Read
List private registries for an organization — github.private-registries.list-org-private-registries Read
Create a private registry for an organization — github.private-registries.create-org-private-registry Write
Get private registries public key for an organization — github.private-registries.get-org-public-key Read
Get a private registry for an organization — github.private-registries.get-org-private-registry Read
Update a private registry for an organization — github.private-registries.update-org-private-registry Write
Delete a private registry for an organization — github.private-registries.delete-org-private-registry Write
List projects for organization — github.projects.list-for-org Read
Get project for organization — github.projects.get-for-org Read
Create draft item for organization owned project — github.projects.create-draft-item-for-org Write
List project fields for organization — github.projects.list-fields-for-org Read
Add a field to an organization-owned project. — github.projects.add-field-for-org Write
Get project field for organization — github.projects.get-field-for-org Read
List items for an organization owned project — github.projects.list-items-for-org Read
Add item to organization owned project — github.projects.add-item-for-org Write
Get an item for an organization owned project — github.projects.get-org-item Read
Update project item for organization — github.projects.update-item-for-org Write
Delete project item for organization — github.projects.delete-item-for-org Write
Create a view for an organization-owned project — github.projects.create-view-for-org Write
List items for an organization project view — github.projects.list-view-items-for-org Read
Get registered app installations for external custom properties — github.orgs.external-properties-for-repos-get-organization-app-installations Read
Register an app installation for external custom properties — github.orgs.external-properties-for-repos-register-organization-app-installation Write
Get all external custom properties for a GitHub App installation in an organization — github.orgs.external-properties-for-repos-get-organization-definitions Read
Create or update external custom property values for organization repositories — github.orgs.external-properties-for-repos-create-or-update-organization-values Write
Create or update external custom property values for a property across organization repositories — github.orgs.external-properties-for-repos-create-or-update-values-for-6035de2edd Write
Remove all external custom property values for a property across all organization repositories — github.orgs.external-properties-for-repos-delete-organization-values Write
Get all custom properties for an organization — github.orgs.custom-properties-for-repos-get-organization-definitions Read
Create or update custom properties for an organization — github.orgs.custom-properties-for-repos-create-or-update-organization-ed341b3e2b Write
Get a custom property for an organization — github.orgs.custom-properties-for-repos-get-organization-definition Read
Create or update a custom property for an organization — github.orgs.custom-properties-for-repos-create-or-update-organization-definition Write
Remove a custom property for an organization — github.orgs.custom-properties-for-repos-delete-organization-definition Write
List custom property values for organization repositories — github.orgs.custom-properties-for-repos-get-organization-values Read
Create or update custom property values for organization repositories — github.orgs.custom-properties-for-repos-create-or-update-organization-values Write
List public organization members — github.orgs.list-public-members Read
Check public organization membership for a user — github.orgs.check-public-membership-for-user Read
Set public organization membership for the authenticated user — github.orgs.set-public-membership-for-authenticated-user Write
Remove public organization membership for the authenticated user — github.orgs.remove-public-membership-for-authenticated-user Write
List organization repositories — github.repos.list-for-org Read
Create an organization repository — github.repos.create-in-org Write
Get all organization repository rulesets — github.repos.get-org-rulesets Read
Create an organization repository ruleset — github.repos.create-org-ruleset Write
List organization rule suites — github.repos.get-org-rule-suites Read
Get an organization rule suite — github.repos.get-org-rule-suite Read
Get an organization repository ruleset — github.repos.get-org-ruleset Read
Update an organization repository ruleset — github.repos.update-org-ruleset Write
Delete an organization repository ruleset — github.repos.delete-org-ruleset Write
Get organization ruleset history — github.orgs.get-org-ruleset-history Read
Get organization ruleset version — github.orgs.get-org-ruleset-version Read
List secret scanning alerts for an organization — github.secret-scanning.list-alerts-for-org Read
List organization custom patterns — github.secret-scanning.list-org-custom-patterns Read
Bulk create organization custom patterns — github.secret-scanning.bulk-create-org-custom-patterns Write
Bulk delete organization custom patterns — github.secret-scanning.bulk-delete-org-custom-patterns Write
Update an organization custom pattern — github.secret-scanning.update-org-custom-pattern Write
List organization pattern configurations — github.secret-scanning.list-org-pattern-configs Read
Update organization pattern configurations — github.secret-scanning.update-org-pattern-configs Write
List repository security advisories for an organization — github.security-advisories.list-org-repository-advisories Read
Get immutable releases settings for an organization — github.orgs.get-immutable-releases-settings Read
Set immutable releases settings for an organization — github.orgs.set-immutable-releases-settings Write
List selected repositories for immutable releases enforcement — github.orgs.get-immutable-releases-settings-repositories Read
Set selected repositories for immutable releases enforcement — github.orgs.set-immutable-releases-settings-repositories Write
Enable a selected repository for immutable releases in an organization — github.orgs.enable-selected-repository-immutable-releases-organization Write
Disable a selected repository for immutable releases in an organization — github.orgs.disable-selected-repository-immutable-releases-organization Write
List hosted compute network configurations for an organization — github.hosted-compute.list-network-configurations-for-org Read
Create a hosted compute network configuration for an organization — github.hosted-compute.create-network-configuration-for-org Write
Get a hosted compute network configuration for an organization — github.hosted-compute.get-network-configuration-for-org Read
Update a hosted compute network configuration for an organization — github.hosted-compute.update-network-configuration-for-org Write
Delete a hosted compute network configuration from an organization — github.hosted-compute.delete-network-configuration-from-org Write
Get a hosted compute network settings resource for an organization — github.hosted-compute.get-network-settings-for-org Read
List teams — github.teams.list Read
Create a team — github.teams.create Write
Get a team by name — github.teams.get-by-name Read
Update a team — github.teams.update-in-org Write
Delete a team — github.teams.delete-in-org Write
List pending team invitations — github.teams.list-pending-invitations-in-org Read
List team members — github.teams.list-members-in-org Read
Get team membership for a user — github.teams.get-membership-for-user-in-org Read
Add or update team membership for a user — github.teams.add-or-update-membership-for-user-in-org Write
Remove team membership for a user — github.teams.remove-membership-for-user-in-org Write
List team repositories — github.teams.list-repos-in-org Read
Check team permissions for a repository — github.teams.check-permissions-for-repo-in-org Read
Add or update team repository permissions — github.teams.add-or-update-repo-permissions-in-org Write
Remove a repository from a team — github.teams.remove-repo-in-org Write
List child teams — github.teams.list-child-in-org Read
Get rate limit status for the authenticated user — github.rate-limit.get Read
Get a repository — github.repos.get Read
Update a repository — github.repos.update Write
Delete a repository — github.repos.delete Write
List artifacts for a repository — github.actions.list-artifacts-for-repo Read
Get an artifact — github.actions.get-artifact Read
Delete an artifact — github.actions.delete-artifact Write
Get GitHub Actions cache retention limit for a repository — github.actions.get-actions-cache-retention-limit-for-repository Read
Set GitHub Actions cache retention limit for a repository — github.actions.set-actions-cache-retention-limit-for-repository Write
Get GitHub Actions cache storage limit for a repository — github.actions.get-actions-cache-storage-limit-for-repository Read
Set GitHub Actions cache storage limit for a repository — github.actions.set-actions-cache-storage-limit-for-repository Write
Get GitHub Actions cache usage for a repository — github.actions.get-actions-cache-usage Read
List GitHub Actions caches for a repository — github.actions.get-actions-cache-list Read
Delete GitHub Actions caches for a repository (using a cache key) — github.actions.delete-actions-cache-by-key Write
Delete a GitHub Actions cache for a repository (using a cache ID) — github.actions.delete-actions-cache-by-id Write
List concurrency groups for a repository — github.actions.list-concurrency-groups-for-repository Read
Get a concurrency group for a repository — github.actions.get-concurrency-group-for-repository Read
Get a job for a workflow run — github.actions.get-job-for-workflow-run Read
Re-run a job from a workflow run — github.actions.re-run-job-for-workflow-run Write
Get the customization template for an OIDC subject claim for a repository — github.actions.get-custom-oidc-sub-claim-for-repo Read
Set the customization template for an OIDC subject claim for a repository — github.actions.set-custom-oidc-sub-claim-for-repo Write
List repository organization secrets — github.actions.list-repo-organization-secrets Read
List repository organization variables — github.actions.list-repo-organization-variables Read
Get GitHub Actions permissions for a repository — github.actions.get-github-actions-permissions-repository Read
Set GitHub Actions permissions for a repository — github.actions.set-github-actions-permissions-repository Write
Get the level of access for workflows outside of the repository — github.actions.get-workflow-access-to-repository Read
Set the level of access for workflows outside of the repository — github.actions.set-workflow-access-to-repository Write
Get artifact and log retention settings for a repository — github.actions.get-artifact-and-log-retention-settings-repository Read
Set artifact and log retention settings for a repository — github.actions.set-artifact-and-log-retention-settings-repository Write
Get fork PR contributor approval permissions for a repository — github.actions.get-fork-pr-contributor-approval-permissions-repository Read
Set fork PR contributor approval permissions for a repository — github.actions.set-fork-pr-contributor-approval-permissions-repository Write
Get private repo fork PR workflow settings for a repository — github.actions.get-private-repo-fork-pr-workflows-settings-repository Read
Set private repo fork PR workflow settings for a repository — github.actions.set-private-repo-fork-pr-workflows-settings-repository Write
Get allowed actions and reusable workflows for a repository — github.actions.get-allowed-actions-repository Read
Set allowed actions and reusable workflows for a repository — github.actions.set-allowed-actions-repository Write
Get default workflow permissions for a repository — github.actions.get-github-actions-default-workflow-permissions-repository Read
Set default workflow permissions for a repository — github.actions.set-github-actions-default-workflow-permissions-repository Write
List repository Actions policies — github.actions.get-repo-actions-policies Read
Create a repository Actions policy — github.actions.create-repo-actions-policy Write
Get a repository Actions policy — github.actions.get-repo-actions-policy Read
Update a repository Actions policy — github.actions.update-repo-actions-policy Write
Delete a repository Actions policy — github.actions.delete-repo-actions-policy Write
List self-hosted runners for a repository — github.actions.list-self-hosted-runners-for-repo Read
Get runner version end-of-life schedule for a repository — github.actions.get-runner-version-deprecation-for-repo Read
List runner applications for a repository — github.actions.list-runner-applications-for-repo Read
Create configuration for a just-in-time runner for a repository — github.actions.generate-runner-jitconfig-for-repo Write
Create a registration token for a repository — github.actions.create-registration-token-for-repo Write
Create a remove token for a repository — github.actions.create-remove-token-for-repo Write
Get a self-hosted runner for a repository — github.actions.get-self-hosted-runner-for-repo Read
Delete a self-hosted runner from a repository — github.actions.delete-self-hosted-runner-from-repo Write
List labels for a self-hosted runner for a repository — github.actions.list-labels-for-self-hosted-runner-for-repo Read
Add custom labels to a self-hosted runner for a repository — github.actions.add-custom-labels-to-self-hosted-runner-for-repo Write
Set custom labels for a self-hosted runner for a repository — github.actions.set-custom-labels-for-self-hosted-runner-for-repo Write
Remove all custom labels from a self-hosted runner for a repository — github.actions.remove-all-custom-labels-from-self-hosted-runner-for-repo Write
Remove a custom label from a self-hosted runner for a repository — github.actions.remove-custom-label-from-self-hosted-runner-for-repo Write
List workflow runs for a repository — github.actions.list-workflow-runs-for-repo Read
Get a workflow run — github.actions.get-workflow-run Read
Delete a workflow run — github.actions.delete-workflow-run Write
Get the review history for a workflow run — github.actions.get-reviews-for-run Read
Approve a workflow run for a fork pull request — github.actions.approve-workflow-run Write
List workflow run artifacts — github.actions.list-workflow-run-artifacts Read
Get a workflow run attempt — github.actions.get-workflow-run-attempt Read
List jobs for a workflow run attempt — github.actions.list-jobs-for-workflow-run-attempt Read
Cancel a workflow run — github.actions.cancel-workflow-run Write
List concurrency groups for a workflow run — github.actions.list-concurrency-groups-for-workflow-run Read
Review custom deployment protection rules for a workflow run — github.actions.review-custom-gates-for-run Write
Force cancel a workflow run — github.actions.force-cancel-workflow-run Write
List jobs for a workflow run — github.actions.list-jobs-for-workflow-run Read
Delete workflow run logs — github.actions.delete-workflow-run-logs Write
Get pending deployments for a workflow run — github.actions.get-pending-deployments-for-run Read
Review pending deployments for a workflow run — github.actions.review-pending-deployments-for-run Write
Re-run a workflow — github.actions.re-run-workflow Write
Re-run failed jobs from a workflow run — github.actions.re-run-workflow-failed-jobs Write
Get workflow run usage — github.actions.get-workflow-run-usage Read
List repository secrets — github.actions.list-repo-secrets Read
Get a repository public key — github.actions.get-repo-public-key Read
Get a repository secret — github.actions.get-repo-secret Read
Create or update a repository secret — github.actions.create-or-update-repo-secret Write
Delete a repository secret — github.actions.delete-repo-secret Write
List repository variables — github.actions.list-repo-variables Read
Create a repository variable — github.actions.create-repo-variable Write
Get a repository variable — github.actions.get-repo-variable Read
Update a repository variable — github.actions.update-repo-variable Write
Delete a repository variable — github.actions.delete-repo-variable Write
List repository workflows — github.actions.list-repo-workflows Read
Get a workflow — github.actions.get-workflow Read
Disable a workflow — github.actions.disable-workflow Write
Create a workflow dispatch event — github.actions.create-workflow-dispatch Write
Enable a workflow — github.actions.enable-workflow Write
List workflow runs for a workflow — github.actions.list-workflow-runs Read
Get workflow usage — github.actions.get-workflow-usage Read
List repository activities — github.repos.list-activities Read
List repository organization secrets — github.agents.list-repo-organization-secrets Read
List repository organization variables — github.agents.list-repo-organization-variables Read
List repository secrets — github.agents.list-repo-secrets Read
Get a repository public key — github.agents.get-repo-public-key Read
Get a repository secret — github.agents.get-repo-secret Read
Create or update a repository secret — github.agents.create-or-update-repo-secret Write
Delete a repository secret — github.agents.delete-repo-secret Write
List repository variables — github.agents.list-repo-variables Read
Create a repository variable — github.agents.create-repo-variable Write
Get a repository variable — github.agents.get-repo-variable Read
Update a repository variable — github.agents.update-repo-variable Write
Delete a repository variable — github.agents.delete-repo-variable Write
List assignees — github.issues.list-assignees Read
Check if a user can be assigned — github.issues.check-user-can-be-assigned Read
Create an attestation — github.repos.create-attestation Write
List attestations — github.repos.list-attestations Read
Get all autolinks of a repository — github.repos.list-autolinks Read
Create an autolink reference for a repository — github.repos.create-autolink Write
Get an autolink reference of a repository — github.repos.get-autolink Read
Delete an autolink reference from a repository — github.repos.delete-autolink Write
Check if Dependabot security updates are enabled for a repository — github.repos.check-automated-security-fixes Read
Enable Dependabot security updates — github.repos.enable-automated-security-fixes Write
Disable Dependabot security updates — github.repos.disable-automated-security-fixes Write
List branches — github.repos.list-branches Read
Get a branch — github.repos.get-branch Read
Get branch protection — github.repos.get-branch-protection Read
Update branch protection — github.repos.update-branch-protection Write
Delete branch protection — github.repos.delete-branch-protection Write
Get admin branch protection — github.repos.get-admin-branch-protection Read
Set admin branch protection — github.repos.set-admin-branch-protection Write
Delete admin branch protection — github.repos.delete-admin-branch-protection Write
Get pull request review protection — github.repos.get-pull-request-review-protection Read
Update pull request review protection — github.repos.update-pull-request-review-protection Write
Delete pull request review protection — github.repos.delete-pull-request-review-protection Write
Get commit signature protection — github.repos.get-commit-signature-protection Read
Create commit signature protection — github.repos.create-commit-signature-protection Write
Delete commit signature protection — github.repos.delete-commit-signature-protection Write
Get status checks protection — github.repos.get-status-checks-protection Read
Update status check protection — github.repos.update-status-check-protection Write
Remove status check protection — github.repos.remove-status-check-protection Write
Get all status check contexts — github.repos.get-all-status-check-contexts Read
Add status check contexts — github.repos.add-status-check-contexts Write
Set status check contexts — github.repos.set-status-check-contexts Write
Remove status check contexts — github.repos.remove-status-check-contexts Write
Get access restrictions — github.repos.get-access-restrictions Read
Delete access restrictions — github.repos.delete-access-restrictions Write
Get apps with access to the protected branch — github.repos.get-apps-with-access-to-protected-branch Read
Add app access restrictions — github.repos.add-app-access-restrictions Write
Set app access restrictions — github.repos.set-app-access-restrictions Write
Remove app access restrictions — github.repos.remove-app-access-restrictions Write
Get teams with access to the protected branch — github.repos.get-teams-with-access-to-protected-branch Read
Add team access restrictions — github.repos.add-team-access-restrictions Write
Set team access restrictions — github.repos.set-team-access-restrictions Write
Remove team access restrictions — github.repos.remove-team-access-restrictions Write
Get users with access to the protected branch — github.repos.get-users-with-access-to-protected-branch Read
Add user access restrictions — github.repos.add-user-access-restrictions Write
Set user access restrictions — github.repos.set-user-access-restrictions Write
Remove user access restrictions — github.repos.remove-user-access-restrictions Write
Rename a branch — github.repos.rename-branch Write
Create a check run — github.checks.create Write
Get a check run — github.checks.get Read
Update a check run — github.checks.update Write
List check run annotations — github.checks.list-annotations Read
Rerequest a check run — github.checks.rerequest-run Write
Create a check suite — github.checks.create-suite Write
Update repository preferences for check suites — github.checks.set-suites-preferences Write
Get a check suite — github.checks.get-suite Read
List check runs in a check suite — github.checks.list-for-suite Read
Rerequest a check suite — github.checks.rerequest-suite Write
List code quality findings for a repository — github.code-quality.list-findings-for-repo Read
Get a code quality finding — github.code-quality.get-finding Read
Get a code quality setup configuration — github.code-quality.get-setup Read
Update a code quality setup configuration — github.code-quality.update-setup Write
Get AI Scan enablement for a repository — github.code-scanning.get-ai-scan-enablement Read
List code scanning alerts for a repository — github.code-scanning.list-alerts-for-repo Read
Get a code scanning alert — github.code-scanning.get-alert Read
Update a code scanning alert — github.code-scanning.update-alert Write
Get the status of an autofix for a code scanning alert — github.code-scanning.get-autofix Read
Create an autofix for a code scanning alert — github.code-scanning.create-autofix Write
Commit an autofix for a code scanning alert — github.code-scanning.commit-autofix Write
List instances of a code scanning alert — github.code-scanning.list-alert-instances Read
List code scanning analyses for a repository — github.code-scanning.list-recent-analyses Read
Get a code scanning analysis for a repository — github.code-scanning.get-analysis Read
Delete a code scanning analysis from a repository — github.code-scanning.delete-analysis Write
List CodeQL databases for a repository — github.code-scanning.list-codeql-databases Read
Get a CodeQL database for a repository — github.code-scanning.get-codeql-database Read
Delete a CodeQL database — github.code-scanning.delete-codeql-database Write
Create a CodeQL variant analysis — github.code-scanning.create-variant-analysis Write
Get the summary of a CodeQL variant analysis — github.code-scanning.get-variant-analysis Read
Get the analysis status of a repository in a CodeQL variant analysis — github.code-scanning.get-variant-analysis-repo-task Read
Get a code scanning default setup configuration — github.code-scanning.get-default-setup Read
Update a code scanning default setup configuration — github.code-scanning.update-default-setup Write
Upload an analysis as SARIF data — github.code-scanning.upload-sarif Write
Get information about a SARIF upload — github.code-scanning.get-sarif Read
Get the code security configuration associated with a repository — github.code-security.get-configuration-for-repository Read
List CODEOWNERS errors — github.repos.codeowners-errors Read
List codespaces in a repository for the authenticated user — github.codespaces.list-in-repository-for-authenticated-user Read
Create a codespace in a repository — github.codespaces.create-with-repo-for-authenticated-user Write
List devcontainer configurations in a repository for the authenticated user — github.codespaces.list-devcontainers-in-repository-for-authenticated-user Read
List available machine types for a repository — github.codespaces.repo-machines-for-authenticated-user Read
Get default attributes for a codespace — github.codespaces.pre-flight-with-repo-for-authenticated-user Read
Check if permissions defined by a devcontainer have been accepted by the authenticated user — github.codespaces.check-permissions-for-devcontainer Read
List repository secrets — github.codespaces.list-repo-secrets Read
Get a repository public key — github.codespaces.get-repo-public-key Read
Get a repository secret — github.codespaces.get-repo-secret Read
Create or update a repository secret — github.codespaces.create-or-update-repo-secret Write
Delete a repository secret — github.codespaces.delete-repo-secret Write
List repository collaborators — github.repos.list-collaborators Read
Check if a user is a repository collaborator — github.repos.check-collaborator Read
Add a repository collaborator — github.repos.add-collaborator Write
Remove a repository collaborator — github.repos.remove-collaborator Write
Get repository permissions for a user — github.repos.get-collaborator-permission-level Read
List commit comments for a repository — github.repos.list-commit-comments-for-repo Read
Get a commit comment — github.repos.get-commit-comment Read
Update a commit comment — github.repos.update-commit-comment Write
Delete a commit comment — github.repos.delete-commit-comment Write
List reactions for a commit comment — github.reactions.list-for-commit-comment Read
Create reaction for a commit comment — github.reactions.create-for-commit-comment Write
Delete a commit comment reaction — github.reactions.delete-for-commit-comment Write
List commits — github.repos.list-commits Read
List branches for HEAD commit — github.repos.list-branches-for-head-commit Read
List commit comments — github.repos.list-comments-for-commit Read
Create a commit comment — github.repos.create-commit-comment Write
List pull requests associated with a commit — github.repos.list-pull-requests-associated-with-commit Read
Get a commit — github.repos.get-commit Read
List check runs for a Git reference — github.checks.list-for-ref Read
List check suites for a Git reference — github.checks.list-suites-for-ref Read
Get the combined status for a specific reference — github.repos.get-combined-status-for-ref Read
List commit statuses for a reference — github.repos.list-commit-statuses-for-ref Read
Get community profile metrics — github.repos.get-community-profile-metrics Read
Compare two commits — github.repos.compare-commits Read
Create or update file contents — github.repos.create-or-update-file-contents Write
Delete a file — github.repos.delete-file Write
List repository contributors — github.repos.list-contributors Read
Get Copilot cloud agent configuration for a repository — github.copilot.get-copilot-cloud-agent-configuration Read
List Dependabot alerts for a repository — github.dependabot.list-alerts-for-repo Read
Get a Dependabot alert — github.dependabot.get-alert Read
Update a Dependabot alert — github.dependabot.update-alert Write
List repository secrets — github.dependabot.list-repo-secrets Read
Get a repository public key — github.dependabot.get-repo-public-key Read
Get a repository secret — github.dependabot.get-repo-secret Read
Create or update a repository secret — github.dependabot.create-or-update-repo-secret Write
Delete a repository secret — github.dependabot.delete-repo-secret Write
Get a diff of the dependencies between commits — github.dependency-graph.diff-range Read
Fetch a software bill of materials (SBOM) for a repository. — github.dependency-graph.fetch-sbom-report Read
Request generation of a software bill of materials (SBOM) for a repository. — github.dependency-graph.generate-sbom-report Read
Create a snapshot of dependencies for a repository — github.dependency-graph.create-repository-snapshot Write
List deployments — github.repos.list-deployments Read
Create a deployment — github.repos.create-deployment Write
Get a deployment — github.repos.get-deployment Read
Delete a deployment — github.repos.delete-deployment Write
List deployment statuses — github.repos.list-deployment-statuses Read
Create a deployment status — github.repos.create-deployment-status Write
Get a deployment status — github.repos.get-deployment-status Read
Create a repository dispatch event — github.repos.create-dispatch-event Write
List environments — github.repos.get-all-environments Read
Get an environment — github.repos.get-environment Read
Create or update an environment — github.repos.create-or-update-environment Write
Delete an environment — github.repos.delete-an-environment Write
List deployment branch policies — github.repos.list-deployment-branch-policies Read
Create a deployment branch policy — github.repos.create-deployment-branch-policy Write
Get a deployment branch policy — github.repos.get-deployment-branch-policy Read
Update a deployment branch policy — github.repos.update-deployment-branch-policy Write
Delete a deployment branch policy — github.repos.delete-deployment-branch-policy Write
Get all deployment protection rules for an environment — github.repos.get-all-deployment-protection-rules Read
Create a custom deployment protection rule on an environment — github.repos.create-deployment-protection-rule Write
List custom deployment rule integrations available for an environment — github.repos.list-custom-deployment-rule-integrations Read
Get a custom deployment protection rule — github.repos.get-custom-deployment-protection-rule Read
Disable a custom protection rule for an environment — github.repos.disable-deployment-protection-rule Write
List environment secrets — github.actions.list-environment-secrets Read
Get an environment public key — github.actions.get-environment-public-key Read
Get an environment secret — github.actions.get-environment-secret Read
Create or update an environment secret — github.actions.create-or-update-environment-secret Write
Delete an environment secret — github.actions.delete-environment-secret Write
List environment variables — github.actions.list-environment-variables Read
Create an environment variable — github.actions.create-environment-variable Write
Get an environment variable — github.actions.get-environment-variable Read
Update an environment variable — github.actions.update-environment-variable Write
Delete an environment variable — github.actions.delete-environment-variable Write
List repository events — github.activity.list-repo-events Read
List forks — github.repos.list-forks Read
Create a fork — github.repos.create-fork Write
Create a blob — github.git.create-blob Write
Get a blob — github.git.get-blob Read
Create a commit — github.git.create-commit Write
Get a commit object — github.git.get-commit Read
List matching references — github.git.list-matching-refs Read
Get a reference — github.git.get-ref Read
Create a reference — github.git.create-ref Write
Update a reference — github.git.update-ref Write
Delete a reference — github.git.delete-ref Write
Create a tag object — github.git.create-tag Write
Get a tag — github.git.get-tag Read
Create a tree — github.git.create-tree Write
Get a tree — github.git.get-tree Read
Get the hash algorithm for a repository — github.repos.get-hash-algorithm Read
List repository webhooks — github.repos.list-webhooks Read
Create a repository webhook — github.repos.create-webhook Write
Get a repository webhook — github.repos.get-webhook Read
Update a repository webhook — github.repos.update-webhook Write
Delete a repository webhook — github.repos.delete-webhook Write
Get a webhook configuration for a repository — github.repos.get-webhook-config-for-repo Read
Update a webhook configuration for a repository — github.repos.update-webhook-config-for-repo Write
List deliveries for a repository webhook — github.repos.list-webhook-deliveries Read
Get a delivery for a repository webhook — github.repos.get-webhook-delivery Read
Redeliver a delivery for a repository webhook — github.repos.redeliver-webhook-delivery Write
Ping a repository webhook — github.repos.ping-webhook Write
Test the push repository webhook — github.repos.test-push-webhook Write
Check if immutable releases are enabled for a repository — github.repos.check-immutable-releases Read
Enable immutable releases — github.repos.enable-immutable-releases Write
Disable immutable releases — github.repos.disable-immutable-releases Write
Get a repository installation for the authenticated app — github.apps.get-repo-installation Read
Get interaction restrictions for a repository — github.interactions.get-restrictions-for-repo Read
Set interaction restrictions for a repository — github.interactions.set-restrictions-for-repo Write
Remove interaction restrictions for a repository — github.interactions.remove-restrictions-for-repo Write
Get pull request creation cap bypass list for a repository — github.interactions.get-pull-request-bypass-list-for-repo Read
Add users to the pull request creation cap bypass list for a repository — github.interactions.set-pull-request-bypass-list-for-repo Write
Remove users from the pull request creation cap bypass list for a repository — github.interactions.remove-pull-request-bypass-list-for-repo Write
Get pull request creation cap for a repository — github.interactions.get-pull-request-creation-cap-for-repo Read
Update pull request creation cap for a repository — github.interactions.update-pull-request-creation-cap-for-repo Write
List repository invitations — github.repos.list-invitations Read
Update a repository invitation — github.repos.update-invitation Write
Delete a repository invitation — github.repos.delete-invitation Write
List issue types for a repository — github.repos.list-issue-types Read
List repository issues — github.issues.list-for-repo Read
Create an issue — github.issues.create Write
List issue comments for a repository — github.issues.list-comments-for-repo Read
Get an issue comment — github.issues.get-comment Read
Update an issue comment — github.issues.update-comment Write
Delete an issue comment — github.issues.delete-comment Write
Pin an issue comment — github.issues.pin-comment Write
Unpin an issue comment — github.issues.unpin-comment Write
List reactions for an issue comment — github.reactions.list-for-issue-comment Read
Create reaction for an issue comment — github.reactions.create-for-issue-comment Write
Delete an issue comment reaction — github.reactions.delete-for-issue-comment Write
List issue events for a repository — github.issues.list-events-for-repo Read
Get an issue event — github.issues.get-event Read
Get an issue — github.issues.get Read
Update an issue — github.issues.update Write
List issue artifacts — github.issues.list-issue-artifacts Read
Create an issue artifact — github.issues.create-issue-artifact Write
Get an issue artifact — github.issues.get-issue-artifact Read
Update an issue artifact — github.issues.update-issue-artifact Write
Delete an issue artifact — github.issues.delete-issue-artifact Write
Add assignees to an issue — github.issues.add-assignees Write
Remove assignees from an issue — github.issues.remove-assignees Write
Check if a user can be assigned to a issue — github.issues.check-user-can-be-assigned-to-issue Read
List issue comments — github.issues.list-comments Read
Create an issue comment — github.issues.create-comment Write
List dependencies an issue is blocked by — github.issues.list-dependencies-blocked-by Read
Add a dependency an issue is blocked by — github.issues.add-blocked-by-dependency Write
Remove dependency an issue is blocked by — github.issues.remove-dependency-blocked-by Write
List dependencies an issue is blocking — github.issues.list-dependencies-blocking Read
List issue events — github.issues.list-events Read
List issue field values for an issue — github.issues.list-issue-field-values-for-issue Read
Add issue field values to an issue — github.issues.add-issue-field-values Write
Set issue field values for an issue — github.issues.set-issue-field-values Write
Delete an issue field value from an issue — github.issues.delete-issue-field-value Write
List labels for an issue — github.issues.list-labels-on-issue Read
Add labels to an issue — github.issues.add-labels Write
Set labels for an issue — github.issues.set-labels Write
Remove all labels from an issue — github.issues.remove-all-labels Write
Remove a label from an issue — github.issues.remove-label Write
Lock an issue — github.issues.lock Write
Unlock an issue — github.issues.unlock Write
Get parent issue — github.issues.get-parent Read
List reactions for an issue — github.reactions.list-for-issue Read
Create reaction for an issue — github.reactions.create-for-issue Write
Delete an issue reaction — github.reactions.delete-for-issue Write
List issues related to an issue — github.issues.list-relates-to Read
Add a related issue — github.issues.add-relates-to Write
Remove a related issue — github.issues.remove-relates-to Write
Remove sub-issue — github.issues.remove-sub-issue Write
List sub-issues — github.issues.list-sub-issues Read
Add sub-issue — github.issues.add-sub-issue Write
Reprioritize sub-issue — github.issues.reprioritize-sub-issue Write
List issue suggestions — github.issues.list-suggestions Read
Approve an issue suggestion — github.issues.approve-suggestion Write
Dismiss an issue suggestion — github.issues.dismiss-suggestion Write
List timeline events for an issue — github.issues.list-events-for-timeline Read
List deploy keys — github.repos.list-deploy-keys Read
Create a deploy key — github.repos.create-deploy-key Write
Get a deploy key — github.repos.get-deploy-key Read
Delete a deploy key — github.repos.delete-deploy-key Write
List labels for a repository — github.issues.list-labels-for-repo Read
Create a label — github.issues.create-label Write
Get a label — github.issues.get-label Read
Update a label — github.issues.update-label Write
Delete a label — github.issues.delete-label Write
List repository languages — github.repos.list-languages Read
Get the license for a repository — github.licenses.get-for-repo Read
Sync a fork branch with the upstream repository — github.repos.merge-upstream Write
Merge a branch — github.repos.merge Write
List milestones — github.issues.list-milestones Read
Create a milestone — github.issues.create-milestone Write
Get a milestone — github.issues.get-milestone Read
Update a milestone — github.issues.update-milestone Write
Delete a milestone — github.issues.delete-milestone Write
List labels for issues in a milestone — github.issues.list-labels-for-milestone Read
List repository notifications for the authenticated user — github.activity.list-repo-notifications-for-authenticated-user Read
Mark repository notifications as read — github.activity.mark-repo-notifications-as-read Write
Get a GitHub Pages site — github.repos.get-pages Read
Create a GitHub Pages site — github.repos.create-pages-site Write
Update information about a GitHub Pages site — github.repos.update-information-about-pages-site Write
Delete a GitHub Pages site — github.repos.delete-pages-site Write
List GitHub Pages builds — github.repos.list-pages-builds Read
Request a GitHub Pages build — github.repos.request-pages-build Write
Get latest Pages build — github.repos.get-latest-pages-build Read
Get GitHub Pages build — github.repos.get-pages-build Read
Create a GitHub Pages deployment — github.repos.create-pages-deployment Write
Get the status of a GitHub Pages deployment — github.repos.get-pages-deployment Read
Cancel a GitHub Pages deployment — github.repos.cancel-pages-deployment Write
Get a DNS health check for GitHub Pages — github.repos.get-pages-health-check Read
Check if private vulnerability reporting is enabled for a repository — github.repos.check-private-vulnerability-reporting Read
Enable private vulnerability reporting for a repository — github.repos.enable-private-vulnerability-reporting Write
Disable private vulnerability reporting for a repository — github.repos.disable-private-vulnerability-reporting Write
Get all custom property values for a repository — github.repos.custom-properties-for-repos-get-repository-values Read
Create or update custom property values for a repository — github.repos.custom-properties-for-repos-create-or-update-repository-values Write
List pull requests — github.pulls.list Read
Create a pull request — github.pulls.create Write
List review comments in a repository — github.pulls.list-review-comments-for-repo Read
Get a review comment for a pull request — github.pulls.get-review-comment Read
Update a review comment for a pull request — github.pulls.update-review-comment Write
Delete a review comment for a pull request — github.pulls.delete-review-comment Write
List reactions for a pull request review comment — github.reactions.list-for-pull-request-review-comment Read
Create reaction for a pull request review comment — github.reactions.create-for-pull-request-review-comment Write
Delete a pull request comment reaction — github.reactions.delete-for-pull-request-comment Write
Get a pull request — github.pulls.get Read
Update a pull request — github.pulls.update Write
Create a codespace from a pull request — github.codespaces.create-with-pr-for-authenticated-user Write
List review comments on a pull request — github.pulls.list-review-comments Read
Create a review comment for a pull request — github.pulls.create-review-comment Write
Create a reply for a review comment — github.pulls.create-reply-for-review-comment Write
List commits on a pull request — github.pulls.list-commits Read
List pull requests files — github.pulls.list-files Read
Check if a pull request has been merged — github.pulls.check-if-merged Read
Merge a pull request — github.pulls.merge Write
Merge a pull request asynchronously — github.pulls.merge-async Write
Get the result of an asynchronous merge — github.pulls.get-merge-async-result Read
Get all requested reviewers for a pull request — github.pulls.list-requested-reviewers Read
Request reviewers for a pull request — github.pulls.request-reviewers Write
Remove requested reviewers from a pull request — github.pulls.remove-requested-reviewers Write
Rerequest reviewers for a pull request — github.pulls.rerequest-reviewers Write
List reviews for a pull request — github.pulls.list-reviews Read
Create a review for a pull request — github.pulls.create-review Write
Get a review for a pull request — github.pulls.get-review Read
Update a review for a pull request — github.pulls.update-review Write
Delete a pending review for a pull request — github.pulls.delete-pending-review Write
List comments for a pull request review — github.pulls.list-comments-for-review Read
Dismiss a review for a pull request — github.pulls.dismiss-review Write
Submit a review for a pull request — github.pulls.submit-review Write
Update a pull request branch — github.pulls.update-branch Write
Get a repository README — github.repos.get-readme Read
Get a repository README for a directory — github.repos.get-readme-in-directory Read
List releases — github.repos.list-releases Read
Create a release — github.repos.create-release Write
Get a release asset — github.repos.get-release-asset Read
Update a release asset — github.repos.update-release-asset Write
Delete a release asset — github.repos.delete-release-asset Write
Generate release notes content for a release — github.repos.generate-release-notes Write
Get the latest release — github.repos.get-latest-release Read
Get a release by tag name — github.repos.get-release-by-tag Read
Get a release — github.repos.get-release Read
Update a release — github.repos.update-release Write
Delete a release — github.repos.delete-release Write
List release assets — github.repos.list-release-assets Read
List reactions for a release — github.reactions.list-for-release Read
Create reaction for a release — github.reactions.create-for-release Write
Delete a release reaction — github.reactions.delete-for-release Write
Get rules for a branch — github.repos.get-branch-rules Read
Get all repository rulesets — github.repos.get-repo-rulesets Read
Create a repository ruleset — github.repos.create-repo-ruleset Write
List repository rule suites — github.repos.get-repo-rule-suites Read
Get a repository rule suite — github.repos.get-repo-rule-suite Read
Get a repository ruleset — github.repos.get-repo-ruleset Read
Update a repository ruleset — github.repos.update-repo-ruleset Write
Delete a repository ruleset — github.repos.delete-repo-ruleset Write
Get repository ruleset history — github.repos.get-repo-ruleset-history Read
Get repository ruleset version — github.repos.get-repo-ruleset-version Read
List secret scanning alerts for a repository — github.secret-scanning.list-alerts-for-repo Read
Get a secret scanning alert — github.secret-scanning.get-alert Read
Update a secret scanning alert — github.secret-scanning.update-alert Write
List locations for a secret scanning alert — github.secret-scanning.list-locations-for-alert Read
List repository custom patterns — github.secret-scanning.list-repo-custom-patterns Read
Bulk create repository custom patterns — github.secret-scanning.bulk-create-repo-custom-patterns Write
Bulk delete repository custom patterns — github.secret-scanning.bulk-delete-repo-custom-patterns Write
Update a repository custom pattern — github.secret-scanning.update-repo-custom-pattern Write
Create a push protection bypass — github.secret-scanning.create-push-protection-bypass Write
Get secret scanning scan history for a repository — github.secret-scanning.get-scan-history Read
List repository security advisories — github.security-advisories.list-repository-advisories Read
Create a repository security advisory — github.security-advisories.create-repository-advisory Write
Privately report a security vulnerability — github.security-advisories.create-private-vulnerability-report Write
Get a repository security advisory — github.security-advisories.get-repository-advisory Read
Update a repository security advisory — github.security-advisories.update-repository-advisory Write
List repository security advisory comments — github.security-advisories.list-repository-advisory-comments Read
Create a repository advisory comment — github.security-advisories.create-repository-advisory-comment Write
Get a repository advisory comment — github.security-advisories.get-repository-advisory-comment Read
Update a repository advisory comment — github.security-advisories.update-repository-advisory-comment Write
Request a CVE for a repository security advisory — github.security-advisories.create-repository-advisory-cve-request Write
Create a temporary private fork — github.security-advisories.create-fork Write
List pull request stacks — github.pull-request-stacks.list Read
Create a pull request stack — github.pull-request-stacks.create Write
Get a pull request stack — github.pull-request-stacks.get Read
Add pull requests to a pull request stack — github.pull-request-stacks.add Write
Remove pull requests from a pull request stack — github.pull-request-stacks.unstack Write
List stargazers — github.activity.list-stargazers-for-repo Read
Get stargazer count — github.activity.get-stargazer-count-for-repo Read
Get repository star history — github.activity.get-stargazer-history-for-repo Read
Get the weekly commit activity — github.repos.get-code-frequency-stats Read
Get the last year of commit activity — github.repos.get-commit-activity-stats Read
Get all contributor commit activity — github.repos.get-contributors-stats Read
Get the weekly commit count — github.repos.get-participation-stats Read
Get the hourly commit count for each day — github.repos.get-punch-card-stats Read
Create a commit status — github.repos.create-commit-status Write
List watchers — github.activity.list-watchers-for-repo Read
Get a repository subscription — github.activity.get-repo-subscription Read
Set a repository subscription — github.activity.set-repo-subscription Write
Delete a repository subscription — github.activity.delete-repo-subscription Write
List repository tags — github.repos.list-tags Read
List repository teams — github.repos.list-teams Read
Get all repository topics — github.repos.get-all-topics Read
Replace all repository topics — github.repos.replace-all-topics Write
Get repository clones — github.repos.get-clones Read
Get top referral paths — github.repos.get-top-paths Read
Get top referral sources — github.repos.get-top-referrers Read
Get page views — github.repos.get-views Read
Transfer a repository — github.repos.transfer Write
Check if vulnerability alerts are enabled for a repository — github.repos.check-vulnerability-alerts Read
Enable vulnerability alerts — github.repos.enable-vulnerability-alerts Write
Disable vulnerability alerts — github.repos.disable-vulnerability-alerts Write
Create a repository using a template — github.repos.create-using-template Write
List public repositories — github.repos.list-public Read
Search code — github.search.code Read
Search commits — github.search.commits Read
Search issues and pull requests — github.search.issues-and-pull-requests Read
Search labels — github.search.labels Read
Search repositories — github.search.repos Read
Search topics — github.search.topics Read
Search users — github.search.users Read
Get the authenticated user — github.users.get-authenticated Read
Update the authenticated user — github.users.update-authenticated Write
List users blocked by the authenticated user — github.users.list-blocked-by-authenticated-user Read
Check if a user is blocked by the authenticated user — github.users.check-blocked Read
Block a user — github.users.block Write
Unblock a user — github.users.unblock Write
List codespaces for the authenticated user — github.codespaces.list-for-authenticated-user Read
Create a codespace for the authenticated user — github.codespaces.create-for-authenticated-user Write
List secrets for the authenticated user — github.codespaces.list-secrets-for-authenticated-user Read
Get public key for the authenticated user — github.codespaces.get-public-key-for-authenticated-user Read
Get a secret for the authenticated user — github.codespaces.get-secret-for-authenticated-user Read
Create or update a secret for the authenticated user — github.codespaces.create-or-update-secret-for-authenticated-user Write
Delete a secret for the authenticated user — github.codespaces.delete-secret-for-authenticated-user Write
List selected repositories for a user secret — github.codespaces.list-repositories-for-secret-for-authenticated-user Read
Add a selected repository to a user secret — github.codespaces.add-repository-for-secret-for-authenticated-user Write
Remove a selected repository from a user secret — github.codespaces.remove-repository-for-secret-for-authenticated-user Write
Get a codespace for the authenticated user — github.codespaces.get-for-authenticated-user Read
Update a codespace for the authenticated user — github.codespaces.update-for-authenticated-user Write
Delete a codespace for the authenticated user — github.codespaces.delete-for-authenticated-user Write
Export a codespace for the authenticated user — github.codespaces.export-for-authenticated-user Write
Get details about a codespace export — github.codespaces.get-export-details-for-authenticated-user Read
List machine types for a codespace — github.codespaces.codespace-machines-for-authenticated-user Read
Create a repository from an unpublished codespace — github.codespaces.publish-for-authenticated-user Write
Start a codespace for the authenticated user — github.codespaces.start-for-authenticated-user Write
Stop a codespace for the authenticated user — github.codespaces.stop-for-authenticated-user Write
Get list of conflicting packages during Docker migration for authenticated-user — github.packages.list-docker-migration-conflicting-packages-for-authen-63152eb7cf Read
Set primary email visibility for the authenticated user — github.users.set-primary-email-visibility-for-authenticated-user Write
List email addresses for the authenticated user — github.users.list-emails-for-authenticated-user Read
Add an email address for the authenticated user — github.users.add-email-for-authenticated-user Write
Delete an email address for the authenticated user — github.users.delete-email-for-authenticated-user Write
List followers of the authenticated user — github.users.list-followers-for-authenticated-user Read
List the people the authenticated user follows — github.users.list-followed-by-authenticated-user Read
Check if a person is followed by the authenticated user — github.users.check-person-is-followed-by-authenticated Read
Follow a user — github.users.follow Write
Unfollow a user — github.users.unfollow Write
List GPG keys for the authenticated user — github.users.list-gpg-keys-for-authenticated-user Read
Create a GPG key for the authenticated user — github.users.create-gpg-key-for-authenticated-user Write
Get a GPG key for the authenticated user — github.users.get-gpg-key-for-authenticated-user Read
Delete a GPG key for the authenticated user — github.users.delete-gpg-key-for-authenticated-user Write
List app installations accessible to the user access token — github.apps.list-installations-for-authenticated-user Read
List repositories accessible to the user access token — github.apps.list-installation-repos-for-authenticated-user Read
Add a repository to an app installation — github.apps.add-repo-to-installation-for-authenticated-user Write
Remove a repository from an app installation — github.apps.remove-repo-from-installation-for-authenticated-user Write
Get interaction restrictions for your public repositories — github.interactions.get-restrictions-for-authenticated-user Read
Set interaction restrictions for your public repositories — github.interactions.set-restrictions-for-authenticated-user Write
Remove interaction restrictions from your public repositories — github.interactions.remove-restrictions-for-authenticated-user Write
List user account issues assigned to the authenticated user — github.issues.list-for-authenticated-user Read
List public SSH keys for the authenticated user — github.users.list-public-ssh-keys-for-authenticated-user Read
Get a public SSH key for the authenticated user — github.users.get-public-ssh-key-for-authenticated-user Read
Delete a public SSH key for the authenticated user — github.users.delete-public-ssh-key-for-authenticated-user Write
List subscriptions for the authenticated user — github.apps.list-subscriptions-for-authenticated-user Read
List subscriptions for the authenticated user (stubbed) — github.apps.list-subscriptions-for-authenticated-user-stubbed Read
List organization memberships for the authenticated user — github.orgs.list-memberships-for-authenticated-user Read
Get an organization membership for the authenticated user — github.orgs.get-membership-for-authenticated-user Read
Update an organization membership for the authenticated user — github.orgs.update-membership-for-authenticated-user Write
List user migrations — github.migrations.list-for-authenticated-user Read
Start a user migration — github.migrations.start-for-authenticated-user Write
Get a user migration status — github.migrations.get-status-for-authenticated-user Read
Delete a user migration archive — github.migrations.delete-archive-for-authenticated-user Write
Unlock a user repository — github.migrations.unlock-repo-for-authenticated-user Write
List repositories for a user migration — github.migrations.list-repos-for-authenticated-user Read
List organizations for the authenticated user — github.orgs.list-for-authenticated-user Read
List packages for the authenticated user's namespace — github.packages.list-packages-for-authenticated-user Read
Get a package for the authenticated user — github.packages.get-package-for-authenticated-user Read
Delete a package for the authenticated user — github.packages.delete-package-for-authenticated-user Write
Restore a package for the authenticated user — github.packages.restore-package-for-authenticated-user Write
List package versions for a package owned by the authenticated user — github.packages.get-all-package-versions-for-package-owned-by-authenticated-user Read
Get a package version for the authenticated user — github.packages.get-package-version-for-authenticated-user Read
Delete a package version for the authenticated user — github.packages.delete-package-version-for-authenticated-user Write
Restore a package version for the authenticated user — github.packages.restore-package-version-for-authenticated-user Write
List public email addresses for the authenticated user — github.users.list-public-emails-for-authenticated-user Read
List repositories for the authenticated user — github.repos.list-for-authenticated-user Read
Create a repository for the authenticated user — github.repos.create-for-authenticated-user Write
List repository invitations for the authenticated user — github.repos.list-invitations-for-authenticated-user Read
Accept a repository invitation — github.repos.accept-invitation-for-authenticated-user Write
Decline a repository invitation — github.repos.decline-invitation-for-authenticated-user Write
List social accounts for the authenticated user — github.users.list-social-accounts-for-authenticated-user Read
Add social accounts for the authenticated user — github.users.add-social-account-for-authenticated-user Write
Delete social accounts for the authenticated user — github.users.delete-social-account-for-authenticated-user Write
List SSH signing keys for the authenticated user — github.users.list-ssh-signing-keys-for-authenticated-user Read
Get an SSH signing key for the authenticated user — github.users.get-ssh-signing-key-for-authenticated-user Read
Delete an SSH signing key for the authenticated user — github.users.delete-ssh-signing-key-for-authenticated-user Write
List repositories starred by the authenticated user — github.activity.list-repos-starred-by-authenticated-user Read
Check if a repository is starred by the authenticated user — github.activity.check-repo-is-starred-by-authenticated-user Read
Star a repository for the authenticated user — github.activity.star-repo-for-authenticated-user Write
Unstar a repository for the authenticated user — github.activity.unstar-repo-for-authenticated-user Write
List repositories watched by the authenticated user — github.activity.list-watched-repos-for-authenticated-user Read
List teams for the authenticated user — github.teams.list-for-authenticated-user Read
Get a user using their ID — github.users.get-by-id Read
Create draft item for user owned project — github.projects.create-draft-item-for-authenticated-user Write
List users — github.users.list Read
Create a view for a user-owned project — github.projects.create-view-for-user Write
Get a user — github.users.get-by-username Read
List attestations by bulk subject digests — github.users.list-attestations-bulk Write
Delete attestations in bulk — github.users.delete-attestations-bulk Write
Delete attestations by subject digest — github.users.delete-attestations-by-subject-digest Write
Delete attestations by ID — github.users.delete-attestations-by-id Write
List attestations — github.users.list-attestations Read
List Copilot Spaces for a user — github.copilot-spaces.list-for-user Read
Create a Copilot Space for a user — github.copilot-spaces.create-for-user Write
Get a Copilot Space for a user — github.copilot-spaces.get-for-user Read
Set a Copilot Space for a user — github.copilot-spaces.update-for-user Write
Delete a Copilot Space for a user — github.copilot-spaces.delete-for-user Write
List collaborators for a Copilot Space for a user — github.copilot-spaces.list-collaborators-for-user Read
Add a collaborator to a Copilot Space for a user — github.copilot-spaces.add-collaborator-for-user Write
Set a collaborator role for a Copilot Space for a user — github.copilot-spaces.update-collaborator-for-user Write
Remove a collaborator from a Copilot Space for a user — github.copilot-spaces.remove-collaborator-for-user Write
List resources for a Copilot Space for a user — github.copilot-spaces.list-resources-for-user Read
Create a resource for a Copilot Space for a user — github.copilot-spaces.create-resource-for-user Write
Get a resource for a Copilot Space for a user — github.copilot-spaces.get-resource-for-user Read
Set a resource for a Copilot Space for a user — github.copilot-spaces.update-resource-for-user Write
Delete a resource from a Copilot Space for a user — github.copilot-spaces.delete-resource-for-user Write
Get list of conflicting packages during Docker migration for user — github.packages.list-docker-migration-conflicting-packages-for-user Read
List events for the authenticated user — github.activity.list-events-for-authenticated-user Read
List organization events for the authenticated user — github.activity.list-org-events-for-authenticated-user Read
List public events for a user — github.activity.list-public-events-for-user Read
List followers of a user — github.users.list-followers-for-user Read
List the people a user follows — github.users.list-following-for-user Read
Check if a user follows another user — github.users.check-following-for-user Read
List gists for a user — github.gists.list-for-user Read
List GPG keys for a user — github.users.list-gpg-keys-for-user Read
Get contextual information for a user — github.users.get-context-for-user Read
Get a user installation for the authenticated app — github.apps.get-user-installation Read
List public keys for a user — github.users.list-public-keys-for-user Read
List organizations for a user — github.orgs.list-for-user Read
List packages for a user — github.packages.list-packages-for-user Read
Get a package for a user — github.packages.get-package-for-user Read
Delete a package for a user — github.packages.delete-package-for-user Write
Restore a package for a user — github.packages.restore-package-for-user Write
List package versions for a package owned by a user — github.packages.get-all-package-versions-for-package-owned-by-user Read
Get a package version for a user — github.packages.get-package-version-for-user Read
Delete package version for a user — github.packages.delete-package-version-for-user Write
Restore package version for a user — github.packages.restore-package-version-for-user Write
List projects for user — github.projects.list-for-user Read
Get project for user — github.projects.get-for-user Read
List project fields for user — github.projects.list-fields-for-user Read
Add field to user owned project — github.projects.add-field-for-user Write
Get project field for user — github.projects.get-field-for-user Read
List items for a user owned project — github.projects.list-items-for-user Read
Add item to user owned project — github.projects.add-item-for-user Write
Get an item for a user owned project — github.projects.get-user-item Read
Update project item for user — github.projects.update-item-for-user Write
Delete project item for user — github.projects.delete-item-for-user Write
List items for a user project view — github.projects.list-view-items-for-user Read
List events received by the authenticated user — github.activity.list-received-events-for-user Read
List public events received by a user — github.activity.list-received-public-events-for-user Read
List repositories for a user — github.repos.list-for-user Read
Get billing AI credit usage report for a user — github.billing.get-github-billing-ai-credit-usage-report-user Read
Get billing premium request usage report for a user — github.billing.get-github-billing-premium-request-usage-report-user Read
Get billing usage report for a user — github.billing.get-github-billing-usage-report-user Read
Get billing usage summary for a user — github.billing.get-github-billing-usage-summary-report-user Read
List social accounts for a user — github.users.list-social-accounts-for-user Read
List SSH signing keys for a user — github.users.list-ssh-signing-keys-for-user Read
List repositories starred by a user — github.activity.list-repos-starred-by-user Read
List repositories watched by a user — github.activity.list-repos-watched-by-user Read
Get all API versions — github.meta.get-all-versions Read
Get the Zen of GitHub — github.meta.get-zen Read

Connect and use

Connect and use

Open the integration's connection form to check the available credential source. The source has not been resolved for this documentation export. The instructions below apply when using your own provider account.

Get your provider credentials

Follow these steps for GitHub, then enter the issued values in the connection form below.

  1. In GitHub Settings, open Developer settings → Personal access tokens → Fine-grained tokens. Select a resource owner, only the repositories and permissions you need, and an expiry; generate the token and paste it into this connection’s GitHub access token field. Organization approval may be required. Then enable the commands for your client API key. Never paste your GitHub token into an MCP URL or client configuration.

Official credential setup

Where to enter credentials

In the integration page, sign in, choose your workspace and open Connect. If a Credentials choice is shown, select Use my credentials. Fill the following connection fields and save. Provider credentials belong in this form, never in an MCP configuration or tool input.

Connection field Requirement
GitHub access token Required

Open API keys and create a Tooluse.net key for the enabled commands.

Set TOOLUSE_API_KEY in your client and use the shared MCP configuration.

Configure Claude Code, Codex or Cursor once

Permissions and results

If you have more than one workspace, check the selected workspace in the connection or API-key dialog before saving. Roles, enabled commands, expiry and revocation use Tooluse.net's existing permissions. Disabling a connection or revoking a key immediately prevents new calls.

Send one Claude tool_use block per request. Keep the same Idempotency-Key when retrying the same request; use a new key for a new call. The response includes the shared Tooluse.net receipt and Claude tool_result. Check both HTTP status and the returned tool result before treating a call as successful.

Your connection's daily allowance and key permissions also apply. Adding a connection does not make a provider request.

Calls return the shared execution receipt and a Claude tool_result. Provider output varies by operation; consult the provider documentation for its response fields. Unconfirmed calls should be checked before retrying.

Call from your client

Use the shared MCP configuration. Refresh your client's tool list after saving the connection or changing key permissions, then call the returned tool name with the example input below.

Configure Claude Code, Codex or Cursor once

Discover your enabled tools

List permitted tools in Claude format. Read every page using page and size (maximum 100) until all results have been received. Use the returned name, not a catalog capability identifier, in the tool_use block.

curl 'https://api.tooluse.net/v1/tools' \
  -H "Authorization: Bearer $TOOLUSE_API_KEY"

Find this command in the tool list permitted by your key. Replace svc_FROM_YOUR_TOOL_LIST with its returned name. Use a new Idempotency-Key for each new call and retain it when retrying that same call.

HTTP call

curl 'https://api.tooluse.net/v1/tool-calls' \
  -H "Authorization: Bearer $TOOLUSE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: replace-with-a-new-call-id' \
  --data '{
  "type": "tool_use",
  "id": "toolu_example",
  "name": "svc_FROM_YOUR_TOOL_LIST",
  "input": {}
}'

Send one Claude tool_use block per request. Keep the same Idempotency-Key when retrying the same request; use a new key for a new call. The response includes the shared Tooluse.net receipt and Claude tool_result. Check both HTTP status and the returned tool result before treating a call as successful.

Commands

GitHub API Root — github.meta.root

Run GitHub API Root with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List global security advisories — github.security-advisories.list-global-advisories

Run List global security advisories with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.ghsa_id string Optional If specified, only advisories with this GHSA (GitHub Security Advisory) identifier will be returned.
query.type string Optional If specified, only advisories of this type will be returned. By default, a request with no other parameters defined will only return reviewed advisories that are not malware. enum: ["reviewed","malware","unreviewed"]; default: "reviewed"
query.cve_id string Optional If specified, only advisories with this CVE (Common Vulnerabilities and Exposures) identifier will be returned.
query.ecosystem — Optional If specified, only advisories for these ecosystems will be returned. $ref: "#/definitions/security-advisory-ecosystems"
query.severity string Optional If specified, only advisories with these severities will be returned. enum: ["unknown","low","medium","high","critical"]
query.cwes — Optional If specified, only advisories with these Common Weakness Enumerations (CWEs) will be returned. Example: cwes=79,284,22 or cwes[]=79&cwes[]=284&cwes[]=22
query.cwes string Optional oneOf[1]
query.cwes array Optional oneOf[2]
query.cwes[] string Optional oneOf[2]
query.is_withdrawn boolean Optional Whether to only return advisories that have been withdrawn.
query.affects — Optional If specified, only return advisories that affect any of package or package@version. A maximum of 1000 packages can be specified. If the query parameter causes the URL to exceed the maximum URL length supported by your client, you must specify fewer packages. Example: affects=package1,[email protected],[email protected] or affects[]=package1&affects[][email protected]
query.affects string Optional oneOf[1]
query.affects array Optional oneOf[2]; maxItems: 1000
query.affects[] string Optional oneOf[2]
query.published string Optional If specified, only return advisories that were published on a date or date range. For more information on the syntax of the date range, see "Understanding the search syntax."
query.updated string Optional If specified, only return advisories that were updated on a date or date range. For more information on the syntax of the date range, see "Understanding the search syntax."
query.modified string Optional If specified, only show advisories that were updated or published on a date or date range. For more information on the syntax of the date range, see "Understanding the search syntax."
query.epss_percentage string Optional If specified, only return advisories that have an EPSS percentage score that matches the provided value. The EPSS percentage represents the likelihood of a CVE being exploited.
query.epss_percentile string Optional If specified, only return advisories that have an EPSS percentile score that matches the provided value. The EPSS percentile represents the relative rank of the CVE's likelihood of being exploited compared to other CVEs.
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30; minimum: 1; maximum: 100
query.sort string Optional The property to sort the results by. enum: ["updated","published","epss_percentage","epss_percentile"]; default: "published"

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a global security advisory — github.security-advisories.get-global-advisory

Run Get a global security advisory with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.ghsa_id string Required The GHSA (GitHub Security Advisory) identifier of the advisory.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "ghsa_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List automations for user — github.agent-automations.list-automations

Run List automations for user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. default: 1; minimum: 1
query.per_page integer Optional The number of results per page (max 100). default: 30; minimum: 1; maximum: 100
query.type string Optional Filter automations by type. personal returns automations owned by their creator, shared returns automations owned by the repository. Omit to return both. enum: ["personal","shared"]

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List automations for a repository — github.agent-automations.list-repo-automations

Run List automations for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository. The name is not case sensitive.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. default: 1; minimum: 1
query.per_page integer Optional The number of results per page (max 100). default: 30; minimum: 1; maximum: 100
query.type string Optional Filter automations by type. personal returns automations owned by their creator, shared returns automations owned by the repository. Omit to return both. enum: ["personal","shared"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an automation for a repository — github.agent-automations.create-repo-automation

Run Create an automation for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository. The name is not case sensitive.
body object Required Request body for creating an automation.
body.name string Required The name of the automation.
body.triggers object Optional Trigger configuration for the automation. additionalProperties: false
body.triggers.interval object Optional additionalProperties: false
body.triggers.interval.cadence array Required One or more schedules on which the Automation runs. minItems: 1; uniqueItems: true
body.triggers.interval.cadence[] string Optional enum: ["hourly","daily","weekly"]
body.triggers.interval.hour_utc integer Optional UTC hour anchor (0 through 23) for daily and weekly schedules. Omitted daily and weekly values default to 0 (midnight UTC). minimum: 0; maximum: 23
body.triggers.interval.day_of_week integer Optional UTC weekday anchor for weekly schedules, where 0 is Sunday and 6 is Saturday. Omitted weekly values default to Monday (1). minimum: 0; maximum: 6
body.triggers.interval.minute_utc integer Optional UTC minute anchor for daily and weekly schedules. Omitted daily and weekly values default to 0. Must be omitted whenever cadence includes hourly. enum: [0,15,30,45]; default: 0
body.triggers.interval.write_scope string Optional Has no effect: scheduled runs can change any resource in the repository, and an organization or repository policy requiring trigger-scoped writes does not apply to them. enum: ["trigger","repository"]
body.triggers.interval.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.issue_opened object Optional additionalProperties: false
body.triggers.issue_opened.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.issue_opened.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.issue_opened.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.issue_labeled object Optional additionalProperties: false
body.triggers.issue_labeled.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.issue_labeled.labels array Optional Label names matched case-insensitively against the label added by the event. Omit or use an empty array to match every added label. uniqueItems: true
body.triggers.issue_labeled.labels[] string Optional
body.triggers.issue_labeled.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.issue_labeled.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.workflow_run object Optional additionalProperties: false
body.triggers.workflow_run.workflows array Required Workflow names matched against the name in each workflow YAML file. minItems: 1
body.triggers.workflow_run.workflows[] string Optional minLength: 1
body.triggers.workflow_run.conclusions array Required Workflow conclusions to match. The current trigger supports failure. minItems: 1; maxItems: 1
body.triggers.workflow_run.conclusions[] string Optional enum: ["failure"]
body.triggers.workflow_run.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.workflow_run.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.workflow_run.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_opened object Optional additionalProperties: false
body.triggers.pull_request_opened.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_opened.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_opened.paths[] string Optional minLength: 1
body.triggers.pull_request_opened.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_opened.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_synchronize object Optional additionalProperties: false
body.triggers.pull_request_synchronize.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_synchronize.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_synchronize.paths[] string Optional minLength: 1
body.triggers.pull_request_synchronize.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_synchronize.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_merged object Optional additionalProperties: false
body.triggers.pull_request_merged.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_merged.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_merged.paths[] string Optional minLength: 1
body.triggers.pull_request_merged.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_merged.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.issue_comment object Optional additionalProperties: false
body.triggers.issue_comment.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.issue_comment.body_substring string Optional A case-insensitive substring matched against the event body.
body.triggers.issue_comment.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.issue_comment.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_comment object Optional additionalProperties: false
body.triggers.pull_request_comment.comment_types array Required Pull request conversation and inline review comment types to match. minItems: 1; maxItems: 2; uniqueItems: true
body.triggers.pull_request_comment.comment_types[] string Optional enum: ["timeline_comment","review_comment"]
body.triggers.pull_request_comment.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_comment.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_comment.paths[] string Optional minLength: 1
body.triggers.pull_request_comment.body_substring string Optional A case-insensitive substring matched against the event body.
body.triggers.pull_request_comment.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_comment.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.discussion_opened object Optional additionalProperties: false
body.triggers.discussion_opened.categories array Optional Discussion category names matched case-insensitively. minItems: 1; uniqueItems: true
body.triggers.discussion_opened.categories[] string Optional
body.triggers.discussion_opened.body_substring string Optional A case-insensitive substring matched against the event body.
body.triggers.discussion_opened.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.discussion_opened.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.discussion_updated object Optional additionalProperties: false
body.triggers.discussion_updated.categories array Optional Discussion category names matched case-insensitively. minItems: 1; uniqueItems: true
body.triggers.discussion_updated.categories[] string Optional
body.triggers.discussion_updated.body_substring string Optional A case-insensitive substring matched against the event body.
body.triggers.discussion_updated.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.discussion_updated.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.discussion_comment object Optional additionalProperties: false
body.triggers.discussion_comment.comment_types array Optional Top-level discussion comments and replies to match. Omit to match both. minItems: 1; maxItems: 2; uniqueItems: true
body.triggers.discussion_comment.comment_types[] string Optional enum: ["comment","reply"]
body.triggers.discussion_comment.categories array Optional Discussion category names matched case-insensitively. minItems: 1; uniqueItems: true
body.triggers.discussion_comment.categories[] string Optional
body.triggers.discussion_comment.body_substring string Optional A case-insensitive substring matched against the event body.
body.triggers.discussion_comment.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.discussion_comment.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.issue_assigned object Optional additionalProperties: false
body.triggers.issue_assigned.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.issue_assigned.assignees array Optional Affected assignee logins matched case-insensitively. minItems: 1; uniqueItems: true
body.triggers.issue_assigned.assignees[] string Optional
body.triggers.issue_assigned.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.issue_assigned.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_assigned object Optional additionalProperties: false
body.triggers.pull_request_assigned.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_assigned.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_assigned.paths[] string Optional minLength: 1
body.triggers.pull_request_assigned.assignees array Optional Affected assignee logins matched case-insensitively. minItems: 1; uniqueItems: true
body.triggers.pull_request_assigned.assignees[] string Optional
body.triggers.pull_request_assigned.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_assigned.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.sub_issue_added object Optional additionalProperties: false
body.triggers.sub_issue_added.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.sub_issue_added.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.sub_issue_added.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_ready_for_review object Optional additionalProperties: false
body.triggers.pull_request_ready_for_review.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_ready_for_review.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_ready_for_review.paths[] string Optional minLength: 1
body.triggers.pull_request_ready_for_review.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_ready_for_review.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_labeled object Optional additionalProperties: false
body.triggers.pull_request_labeled.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_labeled.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_labeled.paths[] string Optional minLength: 1
body.triggers.pull_request_labeled.labels array Optional Label names matched case-insensitively against the label added by the event. Omit or use an empty array to match every added label. uniqueItems: true
body.triggers.pull_request_labeled.labels[] string Optional
body.triggers.pull_request_labeled.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_labeled.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_merge_conflict object Optional additionalProperties: false
body.triggers.pull_request_merge_conflict.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_merge_conflict.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_merge_conflict.paths[] string Optional minLength: 1
body.triggers.pull_request_merge_conflict.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_merge_conflict.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_review_submitted object Optional additionalProperties: false
body.triggers.pull_request_review_submitted.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_review_submitted.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_review_submitted.paths[] string Optional minLength: 1
body.triggers.pull_request_review_submitted.states array Required Submitted review states to match. minItems: 1; maxItems: 3; uniqueItems: true
body.triggers.pull_request_review_submitted.states[] string Optional enum: ["approved","changes_requested","commented"]
body.triggers.pull_request_review_submitted.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_review_submitted.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_review_requested object Optional additionalProperties: false
body.triggers.pull_request_review_requested.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_review_requested.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_review_requested.paths[] string Optional minLength: 1
body.triggers.pull_request_review_requested.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_review_requested.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.issue_closed object Optional additionalProperties: false
body.triggers.issue_closed.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.issue_closed.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.issue_closed.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.issue_reopened object Optional additionalProperties: false
body.triggers.issue_reopened.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.issue_reopened.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.issue_reopened.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_closed object Optional additionalProperties: false
body.triggers.pull_request_closed.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_closed.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_closed.paths[] string Optional minLength: 1
body.triggers.pull_request_closed.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_closed.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_reopened object Optional additionalProperties: false
body.triggers.pull_request_reopened.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_reopened.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_reopened.paths[] string Optional minLength: 1
body.triggers.pull_request_reopened.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_reopened.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_converted_to_draft object Optional additionalProperties: false
body.triggers.pull_request_converted_to_draft.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_converted_to_draft.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_converted_to_draft.paths[] string Optional minLength: 1
body.triggers.pull_request_converted_to_draft.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_converted_to_draft.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_review_dismissed object Optional additionalProperties: false
body.triggers.pull_request_review_dismissed.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_review_dismissed.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_review_dismissed.paths[] string Optional minLength: 1
body.triggers.pull_request_review_dismissed.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_review_dismissed.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_review_thread_resolved object Optional additionalProperties: false
body.triggers.pull_request_review_thread_resolved.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_review_thread_resolved.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_review_thread_resolved.paths[] string Optional minLength: 1
body.triggers.pull_request_review_thread_resolved.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_review_thread_resolved.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_review_thread_unresolved object Optional additionalProperties: false
body.triggers.pull_request_review_thread_unresolved.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_review_thread_unresolved.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_review_thread_unresolved.paths[] string Optional minLength: 1
body.triggers.pull_request_review_thread_unresolved.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_review_thread_unresolved.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.automation_completed object Optional additionalProperties: false
body.triggers.automation_completed.automation_ids array Required Upstream Automation IDs in the same repository. minItems: 1; maxItems: 3; uniqueItems: true
body.triggers.automation_completed.automation_ids[] string Optional
body.triggers.automation_completed.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.automation_completed.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.automation_failed object Optional additionalProperties: false
body.triggers.automation_failed.automation_ids array Required Upstream Automation IDs in the same repository. An Automation cannot list itself, and a user-owned Automation can only be listed by its creator's user-owned Automations. minItems: 1; maxItems: 3; uniqueItems: true
body.triggers.automation_failed.automation_ids[] string Optional
body.triggers.automation_failed.reasons array Optional Failure reasons to match. Omit to match only reported failures. minItems: 1; maxItems: 3; uniqueItems: true
body.triggers.automation_failed.reasons[] string Optional enum: ["reported","crashed","timed_out"]
body.triggers.automation_failed.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.automation_failed.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.code_scanning_alert object Optional Runs on the default branch when a security alert of this kind is created in the repository. These are system events without an issue, pull request, or human actor, and cannot be run manually. additionalProperties: false
body.triggers.code_scanning_alert.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.code_scanning_alert.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.secret_scanning_alert object Optional Runs on the default branch when a security alert of this kind is created in the repository. These are system events without an issue, pull request, or human actor, and cannot be run manually. additionalProperties: false
body.triggers.secret_scanning_alert.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.secret_scanning_alert.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.dependabot_alert object Optional Runs on the default branch when a security alert of this kind is created in the repository. These are system events without an issue, pull request, or human actor, and cannot be run manually. additionalProperties: false
body.triggers.dependabot_alert.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.dependabot_alert.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.prompt string Required The prompt for the automation. maxLength: 10000
body.model string Optional The model to use for sessions triggered by this automation. Omit or leave empty to let the platform select the model.
body.reasoning_effort — Optional The reasoning effort to use for sessions triggered by this automation. Omit or leave empty to use the model's default.
body.reasoning_effort string Optional oneOf[1]; maxLength: 0
body.reasoning_effort string Optional oneOf[2]; enum: ["none","low","medium","high","xhigh","max"]
body.tools array Optional The tools available to the automation.
body.tools[] string Optional
body.enabled boolean Optional Whether the automation should be created enabled. Defaults to true when omitted. default: true
body.type string Optional The type of automation, fixed at creation. personal keeps it private to its creator and its runs act as that user. shared makes it belong to the repository, visible to anyone with read access to the repository and maintainable by anyone with write access to the repository, and its runs act as the Copilot app rather than as a person. shared is rejected when repository ownership is not available for the repository. Supported values: personal, shared. Defaults to personal. enum: ["personal","shared"]; default: "personal"
body.require_actor_write_permission boolean Optional When true, event-triggered runs require the event actor to have repo write permission, even when the org's allow_read_access_triggers policy is enabled. When policy validation is enabled, explicitly setting false returns 422 if effective organization or repository policy disallows read-access triggers. If omitted, defaults to false when policy permits read-access triggers, otherwise true. The actor requirement does not apply to interval-scheduled runs, which always run as the automation owner.
body.continuous_history boolean Optional When true, runs of this automation build on the session history of its previous runs, and runs of the same automation are serialized. Not tracked in revision history. Defaults to false.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "name": "Issue triage",
    "type": "personal",
    "triggers": {
      "issue_opened": {
        "query": "is:open"
      }
    },
    "prompt": "Inspect the new issue and suggest labels, priority, and next steps.",
    "tools": [
      "github/get_file_contents",
      "github/issue_read"
    ],
    "model": "gpt-6-sol",
    "reasoning_effort": "high"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List available automation tools for a repository — github.agent-automations.list-available-repo-automation-tools

Run List available automation tools for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List available automation triggers for a repository — github.agent-automations.list-available-repo-automation-triggers

Run List available automation triggers for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an automation — github.agent-automations.get-repo-automation

Run Get an automation with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository. The name is not case sensitive.
path.automation_id string Required The unique identifier of the automation.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "automation_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update an automation — github.agent-automations.edit-repo-automation

Run Update an automation with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository. The name is not case sensitive.
path.automation_id string Required The unique identifier of the automation.
body object Required Request body for editing an automation. Omitted fields are left unchanged. Explicit null values are rejected.
body.name string Optional The name of the automation.
body.enabled boolean Optional Set to true to enable, false to disable. Omit to leave unchanged.
body.require_actor_write_permission boolean Optional When true, event-triggered runs require the event actor to have repo write permission, even when the org's allow_read_access_triggers policy is enabled. When policy validation is enabled, explicitly setting false returns 422 if effective organization or repository policy disallows read-access triggers. The actor requirement does not apply to interval-scheduled runs, which always run as the automation owner. Omit to leave unchanged.
body.continuous_history boolean Optional When true, runs of this automation build on the session history of its previous runs, and runs of the same automation are serialized. Not tracked in revision history. Omit to leave unchanged.
body.model string Optional The model to use for sessions triggered by this automation. Omit to leave unchanged. Send an empty string to clear the override and let the platform select the model.
body.reasoning_effort — Optional The reasoning effort to use for sessions triggered by this automation. Omit to leave unchanged. Send an empty string to clear the override and use the model's default.
body.reasoning_effort string Optional oneOf[1]; maxLength: 0
body.reasoning_effort string Optional oneOf[2]; enum: ["none","low","medium","high","xhigh","max"]
body.triggers object Optional Trigger configuration for the automation. additionalProperties: false
body.triggers.interval object Optional additionalProperties: false
body.triggers.interval.cadence array Required One or more schedules on which the Automation runs. minItems: 1; uniqueItems: true
body.triggers.interval.cadence[] string Optional enum: ["hourly","daily","weekly"]
body.triggers.interval.hour_utc integer Optional UTC hour anchor (0 through 23) for daily and weekly schedules. Omitted daily and weekly values default to 0 (midnight UTC). minimum: 0; maximum: 23
body.triggers.interval.day_of_week integer Optional UTC weekday anchor for weekly schedules, where 0 is Sunday and 6 is Saturday. Omitted weekly values default to Monday (1). minimum: 0; maximum: 6
body.triggers.interval.minute_utc integer Optional UTC minute anchor for daily and weekly schedules. Omitted daily and weekly values default to 0. Must be omitted whenever cadence includes hourly. enum: [0,15,30,45]; default: 0
body.triggers.interval.write_scope string Optional Has no effect: scheduled runs can change any resource in the repository, and an organization or repository policy requiring trigger-scoped writes does not apply to them. enum: ["trigger","repository"]
body.triggers.interval.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.issue_opened object Optional additionalProperties: false
body.triggers.issue_opened.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.issue_opened.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.issue_opened.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.issue_labeled object Optional additionalProperties: false
body.triggers.issue_labeled.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.issue_labeled.labels array Optional Label names matched case-insensitively against the label added by the event. Omit or use an empty array to match every added label. uniqueItems: true
body.triggers.issue_labeled.labels[] string Optional
body.triggers.issue_labeled.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.issue_labeled.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.workflow_run object Optional additionalProperties: false
body.triggers.workflow_run.workflows array Required Workflow names matched against the name in each workflow YAML file. minItems: 1
body.triggers.workflow_run.workflows[] string Optional minLength: 1
body.triggers.workflow_run.conclusions array Required Workflow conclusions to match. The current trigger supports failure. minItems: 1; maxItems: 1
body.triggers.workflow_run.conclusions[] string Optional enum: ["failure"]
body.triggers.workflow_run.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.workflow_run.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.workflow_run.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_opened object Optional additionalProperties: false
body.triggers.pull_request_opened.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_opened.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_opened.paths[] string Optional minLength: 1
body.triggers.pull_request_opened.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_opened.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_synchronize object Optional additionalProperties: false
body.triggers.pull_request_synchronize.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_synchronize.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_synchronize.paths[] string Optional minLength: 1
body.triggers.pull_request_synchronize.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_synchronize.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_merged object Optional additionalProperties: false
body.triggers.pull_request_merged.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_merged.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_merged.paths[] string Optional minLength: 1
body.triggers.pull_request_merged.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_merged.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.issue_comment object Optional additionalProperties: false
body.triggers.issue_comment.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.issue_comment.body_substring string Optional A case-insensitive substring matched against the event body.
body.triggers.issue_comment.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.issue_comment.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_comment object Optional additionalProperties: false
body.triggers.pull_request_comment.comment_types array Required Pull request conversation and inline review comment types to match. minItems: 1; maxItems: 2; uniqueItems: true
body.triggers.pull_request_comment.comment_types[] string Optional enum: ["timeline_comment","review_comment"]
body.triggers.pull_request_comment.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_comment.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_comment.paths[] string Optional minLength: 1
body.triggers.pull_request_comment.body_substring string Optional A case-insensitive substring matched against the event body.
body.triggers.pull_request_comment.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_comment.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.discussion_opened object Optional additionalProperties: false
body.triggers.discussion_opened.categories array Optional Discussion category names matched case-insensitively. minItems: 1; uniqueItems: true
body.triggers.discussion_opened.categories[] string Optional
body.triggers.discussion_opened.body_substring string Optional A case-insensitive substring matched against the event body.
body.triggers.discussion_opened.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.discussion_opened.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.discussion_updated object Optional additionalProperties: false
body.triggers.discussion_updated.categories array Optional Discussion category names matched case-insensitively. minItems: 1; uniqueItems: true
body.triggers.discussion_updated.categories[] string Optional
body.triggers.discussion_updated.body_substring string Optional A case-insensitive substring matched against the event body.
body.triggers.discussion_updated.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.discussion_updated.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.discussion_comment object Optional additionalProperties: false
body.triggers.discussion_comment.comment_types array Optional Top-level discussion comments and replies to match. Omit to match both. minItems: 1; maxItems: 2; uniqueItems: true
body.triggers.discussion_comment.comment_types[] string Optional enum: ["comment","reply"]
body.triggers.discussion_comment.categories array Optional Discussion category names matched case-insensitively. minItems: 1; uniqueItems: true
body.triggers.discussion_comment.categories[] string Optional
body.triggers.discussion_comment.body_substring string Optional A case-insensitive substring matched against the event body.
body.triggers.discussion_comment.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.discussion_comment.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.issue_assigned object Optional additionalProperties: false
body.triggers.issue_assigned.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.issue_assigned.assignees array Optional Affected assignee logins matched case-insensitively. minItems: 1; uniqueItems: true
body.triggers.issue_assigned.assignees[] string Optional
body.triggers.issue_assigned.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.issue_assigned.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_assigned object Optional additionalProperties: false
body.triggers.pull_request_assigned.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_assigned.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_assigned.paths[] string Optional minLength: 1
body.triggers.pull_request_assigned.assignees array Optional Affected assignee logins matched case-insensitively. minItems: 1; uniqueItems: true
body.triggers.pull_request_assigned.assignees[] string Optional
body.triggers.pull_request_assigned.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_assigned.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.sub_issue_added object Optional additionalProperties: false
body.triggers.sub_issue_added.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.sub_issue_added.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.sub_issue_added.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_ready_for_review object Optional additionalProperties: false
body.triggers.pull_request_ready_for_review.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_ready_for_review.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_ready_for_review.paths[] string Optional minLength: 1
body.triggers.pull_request_ready_for_review.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_ready_for_review.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_labeled object Optional additionalProperties: false
body.triggers.pull_request_labeled.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_labeled.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_labeled.paths[] string Optional minLength: 1
body.triggers.pull_request_labeled.labels array Optional Label names matched case-insensitively against the label added by the event. Omit or use an empty array to match every added label. uniqueItems: true
body.triggers.pull_request_labeled.labels[] string Optional
body.triggers.pull_request_labeled.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_labeled.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_merge_conflict object Optional additionalProperties: false
body.triggers.pull_request_merge_conflict.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_merge_conflict.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_merge_conflict.paths[] string Optional minLength: 1
body.triggers.pull_request_merge_conflict.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_merge_conflict.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_review_submitted object Optional additionalProperties: false
body.triggers.pull_request_review_submitted.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_review_submitted.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_review_submitted.paths[] string Optional minLength: 1
body.triggers.pull_request_review_submitted.states array Required Submitted review states to match. minItems: 1; maxItems: 3; uniqueItems: true
body.triggers.pull_request_review_submitted.states[] string Optional enum: ["approved","changes_requested","commented"]
body.triggers.pull_request_review_submitted.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_review_submitted.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_review_requested object Optional additionalProperties: false
body.triggers.pull_request_review_requested.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_review_requested.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_review_requested.paths[] string Optional minLength: 1
body.triggers.pull_request_review_requested.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_review_requested.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.issue_closed object Optional additionalProperties: false
body.triggers.issue_closed.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.issue_closed.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.issue_closed.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.issue_reopened object Optional additionalProperties: false
body.triggers.issue_reopened.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.issue_reopened.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.issue_reopened.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_closed object Optional additionalProperties: false
body.triggers.pull_request_closed.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_closed.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_closed.paths[] string Optional minLength: 1
body.triggers.pull_request_closed.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_closed.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_reopened object Optional additionalProperties: false
body.triggers.pull_request_reopened.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_reopened.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_reopened.paths[] string Optional minLength: 1
body.triggers.pull_request_reopened.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_reopened.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_converted_to_draft object Optional additionalProperties: false
body.triggers.pull_request_converted_to_draft.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_converted_to_draft.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_converted_to_draft.paths[] string Optional minLength: 1
body.triggers.pull_request_converted_to_draft.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_converted_to_draft.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_review_dismissed object Optional additionalProperties: false
body.triggers.pull_request_review_dismissed.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_review_dismissed.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_review_dismissed.paths[] string Optional minLength: 1
body.triggers.pull_request_review_dismissed.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_review_dismissed.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_review_thread_resolved object Optional additionalProperties: false
body.triggers.pull_request_review_thread_resolved.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_review_thread_resolved.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_review_thread_resolved.paths[] string Optional minLength: 1
body.triggers.pull_request_review_thread_resolved.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_review_thread_resolved.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.pull_request_review_thread_unresolved object Optional additionalProperties: false
body.triggers.pull_request_review_thread_unresolved.query string Optional A GitHub issue or pull request search query. minLength: 1
body.triggers.pull_request_review_thread_unresolved.paths array Optional Gitignore-style changed-file path globs. minItems: 1
body.triggers.pull_request_review_thread_unresolved.paths[] string Optional minLength: 1
body.triggers.pull_request_review_thread_unresolved.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.pull_request_review_thread_unresolved.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.automation_completed object Optional additionalProperties: false
body.triggers.automation_completed.automation_ids array Required Upstream Automation IDs in the same repository. minItems: 1; maxItems: 3; uniqueItems: true
body.triggers.automation_completed.automation_ids[] string Optional
body.triggers.automation_completed.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.automation_completed.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.automation_failed object Optional additionalProperties: false
body.triggers.automation_failed.automation_ids array Required Upstream Automation IDs in the same repository. An Automation cannot list itself, and a user-owned Automation can only be listed by its creator's user-owned Automations. minItems: 1; maxItems: 3; uniqueItems: true
body.triggers.automation_failed.automation_ids[] string Optional
body.triggers.automation_failed.reasons array Optional Failure reasons to match. Omit to match only reported failures. minItems: 1; maxItems: 3; uniqueItems: true
body.triggers.automation_failed.reasons[] string Optional enum: ["reported","crashed","timed_out"]
body.triggers.automation_failed.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.automation_failed.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.code_scanning_alert object Optional Runs on the default branch when a security alert of this kind is created in the repository. These are system events without an issue, pull request, or human actor, and cannot be run manually. additionalProperties: false
body.triggers.code_scanning_alert.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.code_scanning_alert.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.secret_scanning_alert object Optional Runs on the default branch when a security alert of this kind is created in the repository. These are system events without an issue, pull request, or human actor, and cannot be run manually. additionalProperties: false
body.triggers.secret_scanning_alert.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.secret_scanning_alert.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.triggers.dependabot_alert object Optional Runs on the default branch when a security alert of this kind is created in the repository. These are system events without an issue, pull request, or human actor, and cannot be run manually. additionalProperties: false
body.triggers.dependabot_alert.write_scope string Optional Override the Automation write_scope for runs started by this trigger. If omitted, the automation's write_scope is used. Organization or repository policy may restrict the effective scope to trigger. Explicitly setting repository on create or edit returns 422 when policy validation is enabled and that policy applies. enum: ["trigger","repository"]
body.triggers.dependabot_alert.allow_copilot_triggers boolean Optional When true, events Copilot creates, including from other automations and Copilot sessions, can start this automation through this trigger. Defaults to false. The Copilot coding agent app cannot turn it on: creating a trigger with true, or changing it from false to true, returns 422.
body.prompt string Optional The prompt for the automation. maxLength: 10000
body.tools array Optional The tools available to the automation. Send an empty array to clear all tools.
body.tools[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "automation_id": "example"
  },
  "body": {
    "name": "Issue triage and prioritization",
    "enabled": true,
    "model": "gpt-5.4",
    "reasoning_effort": "high",
    "triggers": {
      "issue_opened": {
        "query": "is:open label:auto-triage"
      }
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an automation — github.agent-automations.delete-repo-automation

Run Delete an automation with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository. The name is not case sensitive.
path.automation_id string Required The unique identifier of the automation.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "automation_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List tasks for an automation in a repository — github.agent-automations.list-repo-automation-tasks

Run List tasks for an automation in a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository. The name is not case sensitive.
path.automation_id string Required The unique identifier of the automation.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). default: 30; minimum: 1; maximum: 100
query.page integer Optional The page number of the results to fetch. default: 1; minimum: 1
query.sort string Optional The field to sort results by. Can be updated_at or created_at. enum: ["updated_at","created_at"]; default: "updated_at"
query.direction string Optional The direction to sort results. Can be asc or desc. enum: ["asc","desc"]; default: "desc"
query.state string Optional Comma-separated list of task states to filter by. Can be any combination of: queued, in_progress, completed, failed, idle, waiting_for_user, timed_out, cancelled.
query.is_archived boolean Optional Filter by archived status. When true, returns only archived tasks. When false or omitted, returns only non-archived tasks. Defaults to false. default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "automation_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run an automation — github.agent-automations.create-repo-automation-task

Run Run an automation with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository. The name is not case sensitive.
path.automation_id string Required The unique identifier of the automation.
body object Required Request body for requesting an automation run.
body.event string Required The event to trigger. Only manual is supported. enum: ["manual"]
body.context string Optional Additional context for this automation run, up to 10,000 characters. Supported only when event is manual. The context supplements the automation's configured instructions. maxLength: 10000

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "automation_id": "example"
  },
  "body": {
    "event": "manual",
    "context": "New Sentry issue detected: https://contoso.sentry.io/issues/7796648726"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Agent Merge configuration for a pull request — github.agent-merge.get-agent-merge-enrollment

Run Get Agent Merge configuration for a pull request with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request. minimum: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 42
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update Agent Merge configuration for a pull request — github.agent-merge.put-agent-merge-enrollment

Run Update Agent Merge configuration for a pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request. minimum: 1
body object Required The Agent Merge enrollment configuration additionalProperties: false
body.allowed_actions array Required The set of actions that Copilot may perform on the pull request. minItems: 1; uniqueItems: true
body.allowed_actions[] string Optional An action that Agent Merge is explicitly allowed to perform. enum: ["fix_ci","resolve_merge_conflicts"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 42
  },
  "body": {
    "allowed_actions": [
      "fix_ci"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Disable Agent Merge for a pull request — github.agent-merge.delete-agent-merge-enrollment

Run Disable Agent Merge for a pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request. minimum: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 42
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List tasks for repository — github.agent-tasks.list-tasks-for-repo

Run List tasks for repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). default: 30; minimum: 1; maximum: 100
query.page integer Optional The page number of the results to fetch. default: 1; minimum: 1
query.sort string Optional The field to sort results by. Can be updated_at or created_at. enum: ["updated_at","created_at"]; default: "updated_at"
query.direction string Optional The direction to sort results. Can be asc or desc. enum: ["asc","desc"]; default: "desc"
query.state string Optional Comma-separated list of task states to filter by. Can be any combination of: queued, in_progress, completed, failed, idle, waiting_for_user, timed_out, cancelled.
query.is_archived boolean Optional Filter by archived status. When true, returns only archived tasks. When false or omitted, returns only non-archived tasks. Defaults to false. default: false
query.since string Optional Only show tasks updated at or after this time (ISO 8601 timestamp) format: "date-time"
query.creator_id array Optional Filter tasks by creator user ID. Accepts one or more user IDs.
query.creator_id[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Start a task — github.agent-tasks.create-task-in-repo

Run Start a task with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository. The name is not case sensitive.
body object Required
body.prompt string Required The user's prompt for the agent
body.model string Optional The model to use for this task. The allowed models may change over time and depend on the user's GitHub Copilot plan and organization policies. Currently supported values: claude-sonnet-4.6, claude-opus-4.6, gpt-5.2-codex, gpt-5.3-codex, gpt-5.4, claude-sonnet-4.5, claude-opus-4.5
body.custom_agent string Optional Optional identifier for a custom agent to use for this task. Use the custom agent's filename without the extension - for example, for a .github/agents/performance-optimizer.agent.md custom agent, use performance-optimizer.
body.create_pull_request boolean Optional Whether to create a PR. default: false
body.base_ref string Optional Base ref for new branch/PR
body.head_ref string Optional Head ref for existing branch/PR. If provided with base_ref, the agent looks up open PR context for head_ref targeting base_ref and commits to head_ref instead of creating a new branch.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "prompt": "Fix the login button on the homepage",
    "base_ref": "main"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a task by repo — github.agent-tasks.get-task-by-repo-and-id

Run Get a task by repo with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository. The name is not case sensitive.
path.task_id string Required The unique identifier of the task.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "task_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List tasks — github.agent-tasks.list-tasks

Run List tasks with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). default: 30; minimum: 1; maximum: 100
query.page integer Optional The page number of the results to fetch. default: 1; minimum: 1
query.sort string Optional The field to sort results by. Can be updated_at or created_at. enum: ["updated_at","created_at"]; default: "updated_at"
query.direction string Optional The direction to sort results. Can be asc or desc. enum: ["asc","desc"]; default: "desc"
query.state string Optional Comma-separated list of task states to filter by. Can be any combination of: queued, in_progress, completed, failed, idle, waiting_for_user, timed_out, cancelled.
query.is_archived boolean Optional Filter by archived status. When true, returns only archived tasks. When false or omitted, returns only non-archived tasks. Defaults to false. default: false
query.since string Optional Only show tasks updated at or after this time (ISO 8601 timestamp) format: "date-time"

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a task by ID — github.agent-tasks.get-task-by-id

Run Get a task by ID with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.task_id string Required The unique identifier of the task.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "task_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the authenticated app — github.apps.get-authenticated

Run Get the authenticated app with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a GitHub App from a manifest — github.apps.create-from-manifest

Run Create a GitHub App from a manifest with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.code string Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "code": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a webhook configuration for an app — github.apps.get-webhook-config-for-app

Run Get a webhook configuration for an app with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a webhook configuration for an app — github.apps.update-webhook-config-for-app

Run Update a webhook configuration for an app with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
body object Required
body.url — Optional $ref: "#/definitions/webhook-config-url"
body.content_type — Optional $ref: "#/definitions/webhook-config-content-type"
body.secret — Optional $ref: "#/definitions/webhook-config-secret"
body.insecure_ssl — Optional $ref: "#/definitions/webhook-config-insecure-ssl"

Full JSON Schema

Full JSON Schema

Example input

{
  "body": {
    "content_type": "json",
    "insecure_ssl": "0",
    "secret": "********",
    "url": "https://example.com/webhook"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List deliveries for an app webhook — github.apps.list-webhook-deliveries

Run List deliveries for an app webhook with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.cursor string Optional Used for pagination: the starting delivery from which the page of deliveries is fetched. Refer to the link header for the next and previous page cursors.
query.status string Optional Returns webhook deliveries filtered by delivery outcome classification based on status_code range. A status of success returns deliveries with a status_code in the 200-399 range (inclusive). A status of failure returns deliveries with a status_code in the 400-599 range (inclusive). enum: ["success","failure"]

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a delivery for an app webhook — github.apps.get-webhook-delivery

Run Get a delivery for an app webhook with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.delivery_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "delivery_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Redeliver a delivery for an app webhook — github.apps.redeliver-webhook-delivery

Run Redeliver a delivery for an app webhook with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.delivery_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "delivery_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List installation requests for the authenticated app — github.apps.list-installation-requests-for-authenticated-app

Run List installation requests for the authenticated app with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List installations for the authenticated app — github.apps.list-installations

Run List installations for the authenticated app with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.since string Optional Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.outdated string Optional

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an installation for the authenticated app — github.apps.get-installation

Run Get an installation for the authenticated app with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.installation_id integer Required The unique identifier of the installation.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "installation_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an installation for the authenticated app — github.apps.delete-installation

Run Delete an installation for the authenticated app with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.installation_id integer Required The unique identifier of the installation.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "installation_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an installation access token for an app — github.apps.create-installation-access-token

Run Create an installation access token for an app with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.installation_id integer Required The unique identifier of the installation.
body object Optional
body.repositories array Optional List of repository names that the token should have access to
body.repositories[] string Optional
body.repository_ids array Optional List of repository IDs that the token should have access to
body.repository_ids[] integer Optional
body.permissions — Optional $ref: "#/definitions/app-permissions"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "installation_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Suspend an app installation — github.apps.suspend-installation

Run Suspend an app installation with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.installation_id integer Required The unique identifier of the installation.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "installation_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Unsuspend an app installation — github.apps.unsuspend-installation

Run Unsuspend an app installation with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.installation_id integer Required The unique identifier of the installation.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "installation_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an app authorization — github.apps.delete-authorization

Run Delete an app authorization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.client_id string Required The client ID of the GitHub app.
body object Required
body.access_token string Required The OAuth access token used to authenticate to the GitHub API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "client_id": "example"
  },
  "body": {
    "access_token": "e72e16c7e42f292c6912e7710c838347ae178b4a"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check a token — github.apps.check-token

Run Check a token with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.client_id string Required The client ID of the GitHub app.
body object Required
body.access_token string Required The access_token of the OAuth or GitHub application.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "client_id": "example"
  },
  "body": {
    "access_token": "e72e16c7e42f292c6912e7710c838347ae178b4a"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Reset a token — github.apps.reset-token

Run Reset a token with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.client_id string Required The client ID of the GitHub app.
body object Required
body.access_token string Required The access_token of the OAuth or GitHub application.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "client_id": "example"
  },
  "body": {
    "access_token": "e72e16c7e42f292c6912e7710c838347ae178b4a"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an app token — github.apps.delete-token

Run Delete an app token with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.client_id string Required The client ID of the GitHub app.
body object Required
body.access_token string Required The OAuth access token used to authenticate to the GitHub API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "client_id": "example"
  },
  "body": {
    "access_token": "e72e16c7e42f292c6912e7710c838347ae178b4a"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a scoped access token — github.apps.scope-token

Run Create a scoped access token with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.client_id string Required The client ID of the GitHub app.
body object Required
body.access_token string Required The access token used to authenticate to the GitHub API.
body.target string Optional The name of the user or organization to scope the user access token to. Required unless target_id is specified.
body.target_id integer Optional The ID of the user or organization to scope the user access token to. Required unless target is specified.
body.repositories array Optional The list of repository names to scope the user access token to. repositories may not be specified if repository_ids is specified.
body.repositories[] string Optional
body.repository_ids array Optional The list of repository IDs to scope the user access token to. repository_ids may not be specified if repositories is specified.
body.repository_ids[] integer Optional
body.permissions — Optional $ref: "#/definitions/app-permissions"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "client_id": "example"
  },
  "body": {
    "access_token": "e72e16c7e42f292c6912e7710c838347ae178b4a",
    "target": "octocat",
    "permissions": {
      "metadata": "read",
      "issues": "write",
      "contents": "read"
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an app — github.apps.get-by-slug

Run Get an app with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.app_slug string Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "app_slug": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get all codes of conduct — github.codes-of-conduct.get-all-codes-of-conduct

Run Get all codes of conduct with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a code of conduct — github.codes-of-conduct.get-conduct-code

Run Get a code of conduct with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.key string Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "key": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Revoke a list of credentials — github.credentials.revoke

Run Revoke a list of credentials with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
body object Required
body.credentials array Required A list of credentials to be revoked, up to 1000 per request. minItems: 1; maxItems: 1000
body.credentials[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "body": {
    "credentials": [
      "ghp_1234567890abcdef1234567890abcdef12345678",
      "github_pat_0A1B2C3D4E5F6G7H8I9J0K_ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456",
      "gho_1234567890abcdef1234567890abcdef12345678",
      "ghu_1234567890abcdef1234567890abcdef12345678",
      "ghr_1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get emojis — github.emojis.get

Run Get emojis with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get GitHub Actions cache retention limit for an enterprise — github.actions.get-actions-cache-retention-limit-for-enterprise

Run Get GitHub Actions cache retention limit for an enterprise with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set GitHub Actions cache retention limit for an enterprise — github.actions.set-actions-cache-retention-limit-for-enterprise

Run Set GitHub Actions cache retention limit for an enterprise with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
body — Required $ref: "#/definitions/actions-cache-retention-limit-for-enterprise"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  },
  "body": {}
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get GitHub Actions cache storage limit for an enterprise — github.actions.get-actions-cache-storage-limit-for-enterprise

Run Get GitHub Actions cache storage limit for an enterprise with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set GitHub Actions cache storage limit for an enterprise — github.actions.set-actions-cache-storage-limit-for-enterprise

Run Set GitHub Actions cache storage limit for an enterprise with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
body — Required $ref: "#/definitions/actions-cache-storage-limit-for-enterprise"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  },
  "body": {}
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List OIDC custom property inclusions for an enterprise — github.oidc.list-oidc-custom-property-inclusions-for-enterprise

Run List OIDC custom property inclusions for an enterprise with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an OIDC custom property inclusion for an enterprise — github.oidc.create-oidc-custom-property-inclusion-for-enterprise

Run Create an OIDC custom property inclusion for an enterprise with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
body — Required $ref: "#/definitions/oidc-custom-property-inclusion-input"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  },
  "body": {
    "custom_property_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an OIDC custom property inclusion for an enterprise — github.oidc.delete-oidc-custom-property-inclusion-for-enterprise

Run Delete an OIDC custom property inclusion for an enterprise with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
path.custom_property_name string Required The name of the custom property to remove from OIDC token inclusion

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example",
    "custom_property_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get code security configurations for an enterprise — github.code-security.get-configurations-for-enterprise

Run Get code security configurations for an enterprise with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a code security configuration for an enterprise — github.code-security.create-configuration-for-enterprise

Run Create a code security configuration for an enterprise with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
body object Required additionalProperties: false
body.name string Required The name of the code security configuration. Must be unique within the enterprise.
body.description string Optional A description of the code security configuration maxLength: 255
body.advanced_security string Optional The enablement status of GitHub Advanced Security features. enabled will enable both Code Security and Secret Protection features. > [!WARNING] > code_security and secret_protection are deprecated values for this field. Prefer the individual code_security and secret_protection fields to set the status of these features. enum: ["enabled","disabled","code_security","secret_protection"]; default: "disabled"
body.code_security string Optional The enablement status of GitHub Code Security features. enum: ["enabled","disabled","not_set"]
body.dependency_graph string Optional The enablement status of Dependency Graph enum: ["enabled","disabled","not_set"]; default: "enabled"
body.dependency_graph_autosubmit_action string Optional The enablement status of Automatic dependency submission enum: ["enabled","disabled","not_set"]; default: "disabled"
body.dependency_graph_autosubmit_action_options object Optional Feature options for Automatic dependency submission
body.dependency_graph_autosubmit_action_options.labeled_runners boolean Optional Whether to use runners labeled with 'dependency-submission' or standard GitHub runners. default: false
body.dependabot_alerts string Optional The enablement status of Dependabot alerts enum: ["enabled","disabled","not_set"]; default: "disabled"
body.dependabot_reachability string Optional The enablement status of reachability analysis for Dependabot. Only available for enterprises with access to reachability analysis. Requires Dependabot alerts to be enabled when set to enabled. Must be disabled when Dependabot alerts is disabled. not_set leaves existing repository settings unchanged. enum: ["enabled","disabled","not_set"]; default: "disabled"
body.dependabot_security_updates string Optional The enablement status of Dependabot security updates enum: ["enabled","disabled","not_set"]; default: "disabled"
body.code_scanning_options — Optional $ref: "#/definitions/code-scanning-options"
body.code_scanning_default_setup string Optional The enablement status of code scanning default setup enum: ["enabled","disabled","not_set"]; default: "disabled"
body.code_scanning_default_setup_options — Optional $ref: "#/definitions/code-scanning-default-setup-options"
body.code_scanning_delegated_alert_dismissal string Optional The enablement status of code scanning delegated alert dismissal enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_protection string Optional The enablement status of GitHub Secret Protection features. enum: ["enabled","disabled","not_set"]
body.secret_scanning string Optional The enablement status of secret scanning enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_scanning_push_protection string Optional The enablement status of secret scanning push protection enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_scanning_validity_checks string Optional The enablement status of secret scanning validity checks enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_scanning_non_provider_patterns string Optional The enablement status of secret scanning non provider patterns enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_scanning_generic_secrets string Optional The enablement status of Copilot secret scanning enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_scanning_generic_secrets_push_protection string Optional The enablement status of generic secrets push protection enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_scanning_delegated_alert_dismissal string Optional The enablement status of secret scanning delegated alert dismissal enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_scanning_extended_metadata string Optional The enablement status of secret scanning extended metadata enum: ["enabled","disabled","not_set"]; default: "disabled"
body.private_vulnerability_reporting string Optional The enablement status of private vulnerability reporting enum: ["enabled","disabled","not_set"]; default: "disabled"
body.enforcement string Optional The enforcement status for a security configuration enum: ["enforced","unenforced","enterprise_enforced"]; default: "enforced"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  },
  "body": {
    "name": "High rish settings",
    "description": "This is a code security configuration for octo-enterprise",
    "advanced_security": "enabled",
    "dependabot_alerts": "enabled",
    "dependabot_security_updates": "not_set",
    "secret_scanning": "enabled"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get default code security configurations for an enterprise — github.code-security.get-default-configurations-for-enterprise

Run Get default code security configurations for an enterprise with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Retrieve a code security configuration of an enterprise — github.code-security.get-single-configuration-for-enterprise

Run Retrieve a code security configuration of an enterprise with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
path.configuration_id integer Required The unique identifier of the code security configuration.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example",
    "configuration_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a custom code security configuration for an enterprise — github.code-security.update-enterprise-configuration

Run Update a custom code security configuration for an enterprise with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
path.configuration_id integer Required The unique identifier of the code security configuration.
body object Required additionalProperties: false
body.name string Optional The name of the code security configuration. Must be unique across the enterprise.
body.description string Optional A description of the code security configuration maxLength: 255
body.advanced_security string Optional The enablement status of GitHub Advanced Security features. enabled will enable both Code Security and Secret Protection features. > [!WARNING] > code_security and secret_protection are deprecated values for this field. Prefer the individual code_security and secret_protection fields to set the status of these features. enum: ["enabled","disabled","code_security","secret_protection"]
body.code_security string Optional The enablement status of GitHub Code Security features. enum: ["enabled","disabled","not_set"]
body.dependency_graph string Optional The enablement status of Dependency Graph enum: ["enabled","disabled","not_set"]
body.dependency_graph_autosubmit_action string Optional The enablement status of Automatic dependency submission enum: ["enabled","disabled","not_set"]
body.dependency_graph_autosubmit_action_options object Optional Feature options for Automatic dependency submission
body.dependency_graph_autosubmit_action_options.labeled_runners boolean Optional Whether to use runners labeled with 'dependency-submission' or standard GitHub runners.
body.dependabot_alerts string Optional The enablement status of Dependabot alerts enum: ["enabled","disabled","not_set"]
body.dependabot_reachability string Optional The enablement status of reachability analysis for Dependabot. Only available for enterprises with access to reachability analysis. Requires Dependabot alerts to be enabled when set to enabled. Must be disabled when Dependabot alerts is disabled. not_set leaves existing repository settings unchanged. Omit this field to preserve the configuration's current value. enum: ["enabled","disabled","not_set"]
body.dependabot_security_updates string Optional The enablement status of Dependabot security updates enum: ["enabled","disabled","not_set"]
body.code_scanning_default_setup string Optional The enablement status of code scanning default setup enum: ["enabled","disabled","not_set"]
body.code_scanning_default_setup_options — Optional $ref: "#/definitions/code-scanning-default-setup-options"
body.code_scanning_options — Optional $ref: "#/definitions/code-scanning-options"
body.code_scanning_delegated_alert_dismissal string Optional The enablement status of code scanning delegated alert dismissal enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_protection string Optional The enablement status of GitHub Secret Protection features. enum: ["enabled","disabled","not_set"]
body.secret_scanning string Optional The enablement status of secret scanning enum: ["enabled","disabled","not_set"]
body.secret_scanning_push_protection string Optional The enablement status of secret scanning push protection enum: ["enabled","disabled","not_set"]
body.secret_scanning_validity_checks string Optional The enablement status of secret scanning validity checks enum: ["enabled","disabled","not_set"]
body.secret_scanning_non_provider_patterns string Optional The enablement status of secret scanning non-provider patterns enum: ["enabled","disabled","not_set"]
body.secret_scanning_generic_secrets string Optional The enablement status of Copilot secret scanning enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_scanning_generic_secrets_push_protection string Optional The enablement status of generic secrets push protection enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_scanning_delegated_alert_dismissal string Optional The enablement status of secret scanning delegated alert dismissal enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_scanning_extended_metadata string Optional The enablement status of secret scanning extended metadata enum: ["enabled","disabled","not_set"]; default: "disabled"
body.private_vulnerability_reporting string Optional The enablement status of private vulnerability reporting enum: ["enabled","disabled","not_set"]
body.enforcement string Optional The enforcement status for a security configuration enum: ["enforced","unenforced","enterprise_enforced"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example",
    "configuration_id": 1
  },
  "body": {
    "name": "octo-enterprise recommended settings v2",
    "secret_scanning": "disabled",
    "code_scanning_default_setup": "enabled"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a code security configuration for an enterprise — github.code-security.delete-configuration-for-enterprise

Run Delete a code security configuration for an enterprise with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
path.configuration_id integer Required The unique identifier of the code security configuration.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example",
    "configuration_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Attach an enterprise configuration to repositories — github.code-security.attach-enterprise-configuration

Run Attach an enterprise configuration to repositories with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
path.configuration_id integer Required The unique identifier of the code security configuration.
body object Required additionalProperties: false
body.scope string Required The type of repositories to attach the configuration to. enum: ["all","all_without_configurations"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example",
    "configuration_id": 1
  },
  "body": {
    "scope": "all"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set a code security configuration as a default for an enterprise — github.code-security.set-configuration-as-default-for-enterprise

Run Set a code security configuration as a default for an enterprise with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
path.configuration_id integer Required The unique identifier of the code security configuration.
body object Required
body.default_for_new_repos string Optional Specify which types of repository this security configuration should be applied to by default. enum: ["all","none","private_and_internal","public"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example",
    "configuration_id": 1
  },
  "body": {
    "default_for_new_repos": "all"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get repositories associated with an enterprise code security configuration — github.code-security.get-repositories-for-enterprise-configuration

Run Get repositories associated with an enterprise code security configuration with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
path.configuration_id integer Required The unique identifier of the code security configuration.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.status string Optional A comma-separated list of statuses. If specified, only repositories with these attachment statuses will be returned. Can be: all, attached, attaching, removed, enforced, failed, updating, removed_by_enterprise, enterprise_enforced default: "all"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example",
    "configuration_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Copilot enterprise usage metrics for a specific day — github.copilot.copilot-enterprise-one-day-usage-metrics

Run Get Copilot enterprise usage metrics for a specific day with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
query object Required additionalProperties: false
query.day string Required The day to request data for, in YYYY-MM-DD format. format: "date"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  },
  "query": {
    "day": "2025-10-13"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Copilot enterprise usage metrics — github.copilot.copilot-enterprise-usage-metrics

Run Get Copilot enterprise usage metrics with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Copilot enterprise repository report for a specific day — github.copilot.copilot-enterprise-repos-one-day-report

Run Get Copilot enterprise repository report for a specific day with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
query object Required additionalProperties: false
query.day string Required The day to request data for, in YYYY-MM-DD format. format: "date"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  },
  "query": {
    "day": "2025-10-13"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Copilot enterprise user-teams report for a specific day — github.copilot.copilot-enterprise-user-teams-one-day-report

Run Get Copilot enterprise user-teams report for a specific day with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
query object Required additionalProperties: false
query.day string Required The day to request data for, in YYYY-MM-DD format. format: "date"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  },
  "query": {
    "day": "2025-10-13"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Copilot users usage metrics for a specific day — github.copilot.copilot-users-one-day-usage-metrics

Run Get Copilot users usage metrics for a specific day with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
query object Required additionalProperties: false
query.day string Required The day to request data for, in YYYY-MM-DD format. format: "date"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  },
  "query": {
    "day": "2025-10-13"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Copilot users usage metrics — github.copilot.copilot-users-usage-metrics

Run Get Copilot users usage metrics with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set the coding agent policy for an enterprise — github.copilot.set-enterprise-coding-agent-policy

Run Set the coding agent policy for an enterprise with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
body object Required
body.policy_state string Required The policy state for Copilot cloud agent in the enterprise. Can be one of enabled_for_all_orgs, disabled_for_all_orgs, enabled_for_selected_orgs, or configured_by_org_admins. enum: ["enabled_for_all_orgs","disabled_for_all_orgs","enabled_for_selected_orgs","configured_by_org_admins"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  },
  "body": {
    "policy_state": "enabled_for_all_orgs"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add organizations to the enterprise coding agent policy — github.copilot.add-organizations-to-enterprise-coding-agent-policy

Run Add organizations to the enterprise coding agent policy with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
body object Required
body.organizations array Optional List of organization logins within the enterprise to enable Copilot cloud agent for.
body.organizations[] string Optional
body.custom_properties array Optional List of custom property filters to match organizations. Organizations matching any of the specified property name/value pairs will be included. This is a one-time operation, setting the property on an organization in the future will not automatically update its coding agent policy.
body.custom_properties[] object Optional
body.custom_properties[].property_name string Required The name of the custom property to filter by.
body.custom_properties[].values array Required The values of the custom property to match.
body.custom_properties[].values[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  },
  "body": {
    "organizations": [
      "my-org-1",
      "my-org-2"
    ],
    "custom_properties": [
      {
        "property_name": "department",
        "values": [
          "engineering",
          "security"
        ]
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove organizations from the enterprise coding agent policy — github.copilot.remove-organizations-from-enterprise-coding-agent-policy

Run Remove organizations from the enterprise coding agent policy with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
body object Required
body.organizations array Optional List of organization logins within the enterprise to disable Copilot cloud agent for.
body.organizations[] string Optional
body.custom_properties array Optional List of custom property filters to match organizations. Organizations matching any of the specified property name/value pairs will be included. This is a one-time operation, setting the property on an organization in the future will not automatically update its coding agent policy.
body.custom_properties[] object Optional
body.custom_properties[].property_name string Required The name of the custom property to filter by.
body.custom_properties[].values array Required The values of the custom property to match.
body.custom_properties[].values[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  },
  "body": {
    "organizations": [
      "my-org-1",
      "my-org-2"
    ],
    "custom_properties": [
      {
        "property_name": "department",
        "values": [
          "engineering",
          "security"
        ]
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List Dependabot alerts for an enterprise — github.dependabot.list-alerts-for-enterprise

Run List Dependabot alerts for an enterprise with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
query object Optional additionalProperties: false
query.classification string Optional A comma-separated list of vulnerability classifications. If specified, only alerts for vulnerabilities with these classifications will be returned. Can be: malware, general
query.state string Optional A comma-separated list of states. If specified, only alerts with these states will be returned. Can be: auto_dismissed, dismissed, fixed, open
query.severity string Optional A comma-separated list of severities. If specified, only alerts with these severities will be returned. Can be: low, medium, high, critical
query.ecosystem string Optional A comma-separated list of ecosystems. If specified, only alerts for these ecosystems will be returned. Can be: composer, go, maven, npm, nuget, pip, pub, rubygems, rust
query.package string Optional A comma-separated list of package names. If specified, only alerts for these packages will be returned.
query.epss_percentage string Optional CVE Exploit Prediction Scoring System (EPSS) percentage. Can be specified as: - An exact number (n) - Comparators such as >n, <n, >=n, <=n - A range like n..n, where n is a number from 0.0 to 1.0 Filters the list of alerts based on EPSS percentages. If specified, only alerts with the provided EPSS percentages will be returned.
query.has — Optional Filters the list of alerts based on whether the alert has the given value. If specified, only alerts meeting this criterion will be returned. Multiple has filters can be passed to filter for alerts that have all of the values. Currently, only patch is supported.
query.has string Optional oneOf[1]
query.has array Optional oneOf[2]
query.has[] string Optional oneOf[2]; enum: ["patch"]
query.assignee string Optional Filter alerts by assignees. Provide a comma-separated list of user handles (e.g., octocat or octocat,hubot) to return alerts assigned to any of the specified users. Use * to list alerts with at least one assignee or none to list alerts with no assignees.
query.scope string Optional The scope of the vulnerable dependency. If specified, only alerts with this scope will be returned. enum: ["development","runtime"]
query.relationship string Optional A comma-separated list of relationships of the vulnerable dependency to your project. If specified, only alerts with these relationships will be returned. > [!NOTE] > We are rolling out support for dependency relationship across ecosystems. This value will be "unknown" for all dependencies in unsupported ecosystems.
query.sort string Optional The property by which to sort the results. created means when the alert was created. updated means when the alert's state last changed. epss_percentage sorts alerts by the Exploit Prediction Scoring System (EPSS) percentage. enum: ["created","updated","epss_percentage"]; default: "created"
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Lists the repositories Dependabot can access in an enterprise — github.dependabot.repository-access-for-enterprise

Run Lists the repositories Dependabot can access in an enterprise with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
query object Optional additionalProperties: false
query.page integer Optional The page number of results to fetch. default: 1; minimum: 1
query.per_page integer Optional Number of results per page. default: 30; minimum: 1; maximum: 100

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Updates Dependabot's repository access list for an enterprise — github.dependabot.update-repository-access-for-enterprise

Run Updates Dependabot's repository access list for an enterprise with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
body object Required
body.repository_ids_to_add array Optional List of repository IDs to add.
body.repository_ids_to_add[] integer Optional
body.repository_ids_to_remove array Optional List of repository IDs to remove.
body.repository_ids_to_remove[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  },
  "body": {
    "repository_ids_to_add": [
      123,
      456
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set the default repository access level for Dependabot in an enterprise — github.dependabot.set-repository-access-default-level-for-enterprise

Run Set the default repository access level for Dependabot in an enterprise with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.enterprise string Required The slug version of the enterprise name.
body object Required
body.default_level string Required The default repository access level for Dependabot updates. enum: ["public","internal"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "enterprise": "example"
  },
  "body": {
    "default_level": "public"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List public events — github.activity.list-public-events

Run List public events with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 15
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get feeds — github.activity.get-feeds

Run Get feeds with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List gists for the authenticated user — github.gists.list

Run List gists for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.since string Optional Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a gist — github.gists.create

Run Create a gist with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
body object Required
body.description string Optional Description of the gist
body.files object Required Names and content for the files that make up the gist additionalProperties: {"type":"object","properties":{"content":{"description":"Content of the file","type":"string"}},"required":["content"]}
body.public — Optional
body.public boolean Optional Flag indicating whether the gist is public oneOf[1]; default: false
body.public string Optional oneOf[2]; enum: ["true","false"]; default: "false"

Full JSON Schema

Full JSON Schema

Example input

{
  "body": {
    "description": "Example of a gist",
    "public": false,
    "files": {
      "README.md": {
        "content": "Hello World"
      }
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List public gists — github.gists.list-public

Run List public gists with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.since string Optional Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List starred gists — github.gists.list-starred

Run List starred gists with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.since string Optional Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a gist — github.gists.get

Run Get a gist with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.gist_id string Required The unique identifier of the gist.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "gist_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a gist — github.gists.update

Run Update a gist with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.gist_id string Required The unique identifier of the gist.
body object | null Required
body.description string Optional The description of the gist.
body.files object Optional The gist files to be updated, renamed, or deleted. Each key must match the current filename (including extension) of the targeted gist file. For example: hello.py. To delete a file, set the whole file to null. For example: hello.py : null. The file will also be deleted if the specified object does not contain at least one of content or filename. additionalProperties: {"type":["object","null"],"properties":{"content":{"description":"The new content of the file.","type":"string"},"filename":{"description":"The new filename for the file.","type":["string","null"]}}}

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "gist_id": "example"
  },
  "body": {
    "description": "An updated gist description",
    "files": {
      "README.md": {
        "content": "Hello World from GitHub"
      }
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a gist — github.gists.delete

Run Delete a gist with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.gist_id string Required The unique identifier of the gist.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "gist_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List gist comments — github.gists.list-comments

Run List gist comments with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.gist_id string Required The unique identifier of the gist.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "gist_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a gist comment — github.gists.create-comment

Run Create a gist comment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.gist_id string Required The unique identifier of the gist.
body object Required
body.body string Required The comment text. maxLength: 65535

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "gist_id": "example"
  },
  "body": {
    "body": "This is a comment to a gist"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a gist comment — github.gists.get-comment

Run Get a gist comment with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.gist_id string Required The unique identifier of the gist.
path.comment_id integer Required The unique identifier of the comment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "gist_id": "example",
    "comment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a gist comment — github.gists.update-comment

Run Update a gist comment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.gist_id string Required The unique identifier of the gist.
path.comment_id integer Required The unique identifier of the comment.
body object Required
body.body string Required The comment text. maxLength: 65535

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "gist_id": "example",
    "comment_id": 1
  },
  "body": {
    "body": "This is an update to a comment in a gist"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a gist comment — github.gists.delete-comment

Run Delete a gist comment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.gist_id string Required The unique identifier of the gist.
path.comment_id integer Required The unique identifier of the comment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "gist_id": "example",
    "comment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List gist commits — github.gists.list-commits

Run List gist commits with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.gist_id string Required The unique identifier of the gist.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "gist_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List gist forks — github.gists.list-forks

Run List gist forks with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.gist_id string Required The unique identifier of the gist.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "gist_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Fork a gist — github.gists.fork

Run Fork a gist with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.gist_id string Required The unique identifier of the gist.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "gist_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check if a gist is starred — github.gists.check-is-starred

Run Check if a gist is starred with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.gist_id string Required The unique identifier of the gist.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "gist_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Star a gist — github.gists.star

Run Star a gist with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.gist_id string Required The unique identifier of the gist.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "gist_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Unstar a gist — github.gists.unstar

Run Unstar a gist with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.gist_id string Required The unique identifier of the gist.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "gist_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a gist revision — github.gists.get-revision

Run Get a gist revision with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.gist_id string Required The unique identifier of the gist.
path.sha string Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "gist_id": "example",
    "sha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get all gitignore templates — github.gitignore.get-all-templates

Run Get all gitignore templates with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a gitignore template — github.gitignore.get-template

Run Get a gitignore template with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.name string Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repositories accessible to the app installation — github.apps.list-repos-accessible-to-installation

Run List repositories accessible to the app installation with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Revoke an installation access token — github.apps.revoke-installation-access-token

Run Revoke an installation access token with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List issues assigned to the authenticated user — github.issues.list

Run List issues assigned to the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.filter string Optional Indicates which sorts of issues to return. assigned means issues assigned to you. created means issues created by you. mentioned means issues mentioning you. subscribed means issues you're subscribed to updates for. all or repos means all issues you can see, regardless of participation or creation. enum: ["assigned","created","mentioned","subscribed","repos","all"]; default: "assigned"
query.state string Optional Indicates the state of the issues to return. enum: ["open","closed","all"]; default: "open"
query.labels string Optional A list of comma separated label names. Example: bug,ui,@high
query.sort string Optional What to sort results by. enum: ["created","updated","comments"]; default: "created"
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.since string Optional Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.collab boolean Optional
query.orgs boolean Optional
query.owned boolean Optional
query.pulls boolean Optional
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get all commonly used licenses — github.licenses.get-all-commonly-used

Run Get all commonly used licenses with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.featured boolean Optional
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a license — github.licenses.get

Run Get a license with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.license string Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "license": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Render a Markdown document — github.markdown.render

Run Render a Markdown document with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
body object Required
body.text string Required The Markdown text to render in HTML.
body.mode string Optional The rendering mode. enum: ["markdown","gfm"]; default: "markdown"
body.context string Optional The repository context to use when creating references in gfm mode. For example, setting context to octo-org/octo-repo will change the text #42 into an HTML link to issue 42 in the octo-org/octo-repo repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "body": {
    "text": "Hello **world**"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a subscription plan for an account — github.apps.get-subscription-plan-for-account

Run Get a subscription plan for an account with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.account_id integer Required account_id parameter

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "account_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List plans — github.apps.list-plans

Run List plans with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List accounts for a plan — github.apps.list-accounts-for-plan

Run List accounts for a plan with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.plan_id integer Required The unique identifier of the plan.
query object Optional additionalProperties: false
query.sort string Optional The property to sort the results by. enum: ["created","updated"]; default: "created"
query.direction string Optional To return the oldest accounts first, set to asc. Ignored without the sort parameter. enum: ["asc","desc"]
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "plan_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a subscription plan for an account (stubbed) — github.apps.get-subscription-plan-for-account-stubbed

Run Get a subscription plan for an account (stubbed) with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.account_id integer Required account_id parameter

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "account_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List plans (stubbed) — github.apps.list-plans-stubbed

Run List plans (stubbed) with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List accounts for a plan (stubbed) — github.apps.list-accounts-for-plan-stubbed

Run List accounts for a plan (stubbed) with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.plan_id integer Required The unique identifier of the plan.
query object Optional additionalProperties: false
query.sort string Optional The property to sort the results by. enum: ["created","updated"]; default: "created"
query.direction string Optional To return the oldest accounts first, set to asc. Ignored without the sort parameter. enum: ["asc","desc"]
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "plan_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get GitHub meta information — github.meta.get

Run Get GitHub meta information with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List public events for a network of repositories — github.activity.list-public-events-for-repo-network

Run List public events for a network of repositories with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List notifications for the authenticated user — github.activity.list-notifications-for-authenticated-user

Run List notifications for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.all boolean Optional If true, show notifications marked as read. default: false
query.participating boolean Optional If true, only shows notifications in which the user is directly participating or mentioned. default: false
query.since string Optional Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.before string Optional Only show notifications updated before the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 50). For more information, see "Using pagination in the REST API." default: 50

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Mark notifications as read — github.activity.mark-notifications-as-read

Run Mark notifications as read with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
body object Optional
body.last_read_at string Optional Describes the last point that notifications were checked. Anything updated since this time will not be marked as read. If you omit this parameter, all notifications are marked as read. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. Default: The current timestamp. format: "date-time"
body.read boolean Optional Whether the notification has been read.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a thread — github.activity.get-thread

Run Get a thread with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.thread_id integer Required The unique identifier of the notification thread. This corresponds to the value returned in the id field when you retrieve notifications (for example with the GET /notifications operation).

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "thread_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Mark a thread as read — github.activity.mark-thread-as-read

Run Mark a thread as read with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.thread_id integer Required The unique identifier of the notification thread. This corresponds to the value returned in the id field when you retrieve notifications (for example with the GET /notifications operation).

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "thread_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Mark a thread as done — github.activity.mark-thread-as-done

Run Mark a thread as done with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.thread_id integer Required The unique identifier of the notification thread. This corresponds to the value returned in the id field when you retrieve notifications (for example with the GET /notifications operation).

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "thread_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a thread subscription for the authenticated user — github.activity.get-thread-subscription-for-authenticated-user

Run Get a thread subscription for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.thread_id integer Required The unique identifier of the notification thread. This corresponds to the value returned in the id field when you retrieve notifications (for example with the GET /notifications operation).

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "thread_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set a thread subscription — github.activity.set-thread-subscription

Run Set a thread subscription with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.thread_id integer Required The unique identifier of the notification thread. This corresponds to the value returned in the id field when you retrieve notifications (for example with the GET /notifications operation).
body object Optional
body.ignored boolean Optional Whether to block all notifications from a thread. default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "thread_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a thread subscription — github.activity.delete-thread-subscription

Run Delete a thread subscription with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.thread_id integer Required The unique identifier of the notification thread. This corresponds to the value returned in the id field when you retrieve notifications (for example with the GET /notifications operation).

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "thread_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Octocat — github.meta.get-octocat

Run Get Octocat with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.s string Optional The words to show in Octocat's speech bubble

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organizations — github.orgs.list

Run List organizations with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.since integer Optional An organization ID. Only return organizations with an ID greater than this ID.
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get GitHub Actions cache retention limit for an organization — github.actions.get-actions-cache-retention-limit-for-organization

Run Get GitHub Actions cache retention limit for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set GitHub Actions cache retention limit for an organization — github.actions.set-actions-cache-retention-limit-for-organization

Run Set GitHub Actions cache retention limit for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body — Required $ref: "#/definitions/actions-cache-retention-limit-for-organization"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {}
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get GitHub Actions cache storage limit for an organization — github.actions.get-actions-cache-storage-limit-for-organization

Run Get GitHub Actions cache storage limit for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set GitHub Actions cache storage limit for an organization — github.actions.set-actions-cache-storage-limit-for-organization

Run Set GitHub Actions cache storage limit for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body — Required $ref: "#/definitions/actions-cache-storage-limit-for-organization"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {}
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get billing AI credit usage report for an organization — github.billing.get-github-billing-ai-credit-usage-report-org

Run Get billing AI credit usage report for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.year integer Optional If specified, only return results for a single year. The value of year is an integer with four digits representing a year. For example, 2025. Default value is the current year.
query.month integer Optional If specified, only return results for a single month. The value of month is an integer between 1 and 12. Default value is the current month. If no year is specified the default year is used.
query.day integer Optional If specified, only return results for a single day. The value of day is an integer between 1 and 31. If no year or month is specified, the default year and month are used.
query.user string Optional The user name to query usage for. The name is not case sensitive.
query.model string Optional The model name to query usage for. The name is not case sensitive.
query.product string Optional The product name to query usage for. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get all budgets for an organization — github.billing.get-all-budgets-org

Run Get all budgets for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. default: 1
query.per_page integer Optional The number of results per page (max 100). default: 10
query.scope string Optional Filter budgets by scope type. - organization: Budgets scoped to the organization. - repository: Budgets scoped to a repository. - multi_user_customer: Universal budgets that apply to all users in the organization. - user: Budgets scoped to an individual user. enum: ["enterprise","organization","repository","cost_center","multi_user_customer","user"]
query.user string Optional Filter consumed amount details for budgets by the specified user login.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a budget for an organization — github.billing.create-organization-budget

Run Create a budget for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Optional
body.budget_amount integer Optional The budget amount in whole dollars. For license-based products, this represents the number of licenses.
body.prevent_further_usage boolean Optional Whether to prevent additional spending once the budget is exceeded. For user and multi_user_customer scopes, this must be true.
body.budget_alerting object Optional
body.budget_alerting.will_alert boolean Optional Whether alerts are enabled for this budget. Rejected for user-scope as alerting is always disabled for them.
body.budget_alerting.alert_recipients array Optional Array of user login names who will receive alerts. Rejected for user-scope as alerting is always disabled for them.
body.budget_alerting.alert_recipients[] string Optional
body.budget_scope string Optional The scope of the budget for this organization. - organization: Apply the budget to the organization. - repository: Apply the budget to a specific repository in the organization. - multi_user_customer: Apply a universal budget to all users in the organization. - user: Apply the budget to a single user in the organization. user and multi_user_customer scopes are only supported when budget_product_sku is ai_credits or premium_requests. enum: ["organization","repository","multi_user_customer","user"]
body.budget_entity_name string Optional The entity to apply the budget to. The expected value depends on budget_scope. - repository: The repository name, or owner/repo. - organization, multi_user_customer, and user: Not used. For user, set the user field instead. default: ""
body.budget_type — Optional The type of pricing model used by the budget. Determines how budget_product_sku is interpreted. - BundlePricing: Covers all AI credit SKUs. Set budget_product_sku to ai_credits. - ProductPricing: Covers all SKUs that belong to a product. Set budget_product_sku to a product such as actions or packages. - SkuPricing: Covers a single, specific SKU. Set budget_product_sku to a SKU such as actions_linux.
body.budget_type string Optional oneOf[1]; enum: ["BundlePricing"]
body.budget_type string Optional oneOf[2]; enum: ["ProductPricing"]
body.budget_type string Optional oneOf[3]; enum: ["SkuPricing"]
body.budget_product_sku string Optional A single product or SKU that will be covered in the budget
body.user string Optional The username of the user for user scope budgets. This field is required when budget_scope is user.
body.expires_at string Optional The date the budget will expire in YYYY-MM-DD format. Only dates in the future are accepted. If not provided, the budget will not expire. Only supported for budgets with budget_scope of user format: "date"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a budget by ID for an organization — github.billing.get-budget-org

Run Get a budget by ID for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.budget_id string Required The ID corresponding to the budget.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "budget_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a budget for an organization — github.billing.update-budget-org

Run Update a budget for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.budget_id string Required The ID corresponding to the budget.
body object Required
body.budget_amount integer Optional The budget amount in whole dollars. For license-based products, this represents the number of licenses.
body.prevent_further_usage boolean Optional Whether to prevent additional spending once the budget is exceeded. For budgets with user or multi_user_customer scope, this must remain true.
body.budget_alerting object Optional
body.budget_alerting.will_alert boolean Optional Whether alerts are enabled for this budget. Ignored for user-scopes as alerting is always disabled for them.
body.budget_alerting.alert_recipients array Optional Array of user login names who will receive alerts. Ignored for user-scopes as alerting is always disabled for them.
body.budget_alerting.alert_recipients[] string Optional
body.expires_at — Optional The date the budget will expire in YYYY-MM-DD format. Only dates in the future are accepted. If not set, the budget will not expire. Setting to null or 0 will remove the expiration date from a budget if set. Only supported for existing user-scoped budgets.
body.expires_at string | null Optional oneOf[1]; format: "date"
body.expires_at integer Optional oneOf[2]; enum: [0]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "budget_id": "example"
  },
  "body": {
    "prevent_further_usage": false,
    "budget_amount": 10,
    "budget_alerting": {
      "will_alert": false,
      "alert_recipients": []
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a budget for an organization — github.billing.delete-budget-org

Run Delete a budget for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.budget_id string Required The ID corresponding to the budget.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "budget_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get billing premium request usage report for an organization — github.billing.get-github-billing-premium-request-usage-report-org

Run Get billing premium request usage report for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.year integer Optional If specified, only return results for a single year. The value of year is an integer with four digits representing a year. For example, 2025. Default value is the current year.
query.month integer Optional If specified, only return results for a single month. The value of month is an integer between 1 and 12. Default value is the current month. If no year is specified the default year is used.
query.day integer Optional If specified, only return results for a single day. The value of day is an integer between 1 and 31. If no year or month is specified, the default year and month are used.
query.user string Optional The user name to query usage for. The name is not case sensitive.
query.model string Optional The model name to query usage for. The name is not case sensitive.
query.product string Optional The product name to query usage for. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get billing usage report for an organization — github.billing.get-github-billing-usage-report-org

Run Get billing usage report for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.year integer Optional If specified, only return results for a single year. The value of year is an integer with four digits representing a year. For example, 2025. Default value is the current year.
query.month integer Optional If specified, only return results for a single month. The value of month is an integer between 1 and 12. If no year is specified the default year is used.
query.day integer Optional If specified, only return results for a single day. The value of day is an integer between 1 and 31. If no year or month is specified, the default year and month are used.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get billing usage summary for an organization — github.billing.get-github-billing-usage-summary-report-org

Run Get billing usage summary for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.year integer Optional If specified, only return results for a single year. The value of year is an integer with four digits representing a year. For example, 2025. Default value is the current year.
query.month integer Optional If specified, only return results for a single month. The value of month is an integer between 1 and 12. Default value is the current month. If no year is specified the default year is used.
query.day integer Optional If specified, only return results for a single day. The value of day is an integer between 1 and 31. If no year or month is specified, the default year and month are used.
query.repository string Optional The repository name to query for usage in the format owner/repository.
query.product string Optional The product name to query usage for. The name is not case sensitive.
query.sku string Optional The SKU to query for usage.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization — github.orgs.get

Run Get an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update an organization — github.orgs.update

Run Update an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Optional
body.billing_email string Optional Billing email address. This address is not publicized.
body.company string Optional The company name.
body.email string Optional The publicly visible email address.
body.twitter_username string Optional The Twitter username of the company.
body.location string Optional The location.
body.name string Optional The shorthand name of the company.
body.description string Optional The description of the company. The maximum size is 160 characters.
body.has_organization_projects boolean Optional Whether an organization can use organization projects.
body.has_repository_projects boolean Optional Whether repositories that belong to the organization can use repository projects.
body.default_repository_permission string Optional Default permission level members have for organization repositories. enum: ["read","write","admin","none"]; default: "read"
body.members_can_create_repositories boolean Optional Whether of non-admin organization members can create repositories. Note: A parameter can override this parameter. See members_allowed_repository_creation_type in this table for details. default: true
body.members_can_create_internal_repositories boolean Optional Whether organization members can create internal repositories, which are visible to all enterprise members. You can only allow members to create internal repositories if your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+. For more information, see "Restricting repository creation in your organization" in the GitHub Help documentation.
body.members_can_create_private_repositories boolean Optional Whether organization members can create private repositories, which are visible to organization members with permission. For more information, see "Restricting repository creation in your organization" in the GitHub Help documentation.
body.members_can_create_public_repositories boolean Optional Whether organization members can create public repositories, which are visible to anyone. For more information, see "Restricting repository creation in your organization" in the GitHub Help documentation.
body.members_allowed_repository_creation_type string Optional Specifies which types of repositories non-admin organization members can create. private is only available to repositories that are part of an organization on GitHub Enterprise Cloud. Note: This parameter is closing down and will be removed in the future. Its return value ignores internal repositories. Using this parameter overrides values set in members_can_create_repositories. See the parameter deprecation notice in the operation description for details. enum: ["all","private","none"]
body.members_can_create_pages boolean Optional Whether organization members can create GitHub Pages sites. Existing published sites will not be impacted. default: true
body.members_can_create_public_pages boolean Optional Whether organization members can create public GitHub Pages sites. Existing published sites will not be impacted. default: true
body.members_can_create_private_pages boolean Optional Whether organization members can create private GitHub Pages sites. Existing published sites will not be impacted. default: true
body.members_can_fork_private_repositories boolean Optional Whether organization members can fork private organization repositories. default: false
body.web_commit_signoff_required boolean Optional Whether contributors to organization repositories are required to sign off on commits they make through GitHub's web interface. default: false
body.blog string Optional
body.advanced_security_enabled_for_new_repositories boolean Optional Endpoint closing down notice. Please use code security configurations instead. Whether GitHub Advanced Security is automatically enabled for new repositories and repositories transferred to this organization. To use this parameter, you must have admin permissions for the repository or be an owner or security manager for the organization that owns the repository. For more information, see "Managing security managers in your organization." You can check which security and analysis features are currently enabled by using a GET /orgs/{org} request.
body.dependabot_alerts_enabled_for_new_repositories boolean Optional Endpoint closing down notice. Please use code security configurations instead. Whether Dependabot alerts are automatically enabled for new repositories and repositories transferred to this organization. To use this parameter, you must have admin permissions for the repository or be an owner or security manager for the organization that owns the repository. For more information, see "Managing security managers in your organization." You can check which security and analysis features are currently enabled by using a GET /orgs/{org} request.
body.dependabot_security_updates_enabled_for_new_repositories boolean Optional Endpoint closing down notice. Please use code security configurations instead. Whether Dependabot security updates are automatically enabled for new repositories and repositories transferred to this organization. To use this parameter, you must have admin permissions for the repository or be an owner or security manager for the organization that owns the repository. For more information, see "Managing security managers in your organization." You can check which security and analysis features are currently enabled by using a GET /orgs/{org} request.
body.dependency_graph_enabled_for_new_repositories boolean Optional Endpoint closing down notice. Please use code security configurations instead. Whether dependency graph is automatically enabled for new repositories and repositories transferred to this organization. To use this parameter, you must have admin permissions for the repository or be an owner or security manager for the organization that owns the repository. For more information, see "Managing security managers in your organization." You can check which security and analysis features are currently enabled by using a GET /orgs/{org} request.
body.secret_scanning_enabled_for_new_repositories boolean Optional Endpoint closing down notice. Please use code security configurations instead. Whether secret scanning is automatically enabled for new repositories and repositories transferred to this organization. To use this parameter, you must have admin permissions for the repository or be an owner or security manager for the organization that owns the repository. For more information, see "Managing security managers in your organization." You can check which security and analysis features are currently enabled by using a GET /orgs/{org} request.
body.secret_scanning_push_protection_enabled_for_new_repositories boolean Optional Endpoint closing down notice. Please use code security configurations instead. Whether secret scanning push protection is automatically enabled for new repositories and repositories transferred to this organization. To use this parameter, you must have admin permissions for the repository or be an owner or security manager for the organization that owns the repository. For more information, see "Managing security managers in your organization." You can check which security and analysis features are currently enabled by using a GET /orgs/{org} request.
body.secret_scanning_push_protection_custom_link_enabled boolean Optional Whether a custom link is shown to contributors who are blocked from pushing a secret by push protection.
body.secret_scanning_push_protection_custom_link string Optional If secret_scanning_push_protection_custom_link_enabled is true, the URL that will be displayed to contributors who are blocked from pushing a secret.
body.deploy_keys_enabled_for_repositories boolean Optional Controls whether or not deploy keys may be added and used for repositories in the organization.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an organization — github.orgs.delete

Run Delete an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get GitHub Actions cache usage for an organization — github.actions.get-actions-cache-usage-for-org

Run Get GitHub Actions cache usage for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repositories with GitHub Actions cache usage for an organization — github.actions.get-actions-cache-usage-by-repo-for-org

Run List repositories with GitHub Actions cache usage for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List GitHub-hosted runners for an organization — github.actions.list-hosted-runners-for-org

Run List GitHub-hosted runners for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a GitHub-hosted runner for an organization — github.actions.create-hosted-runner-for-org

Run Create a GitHub-hosted runner for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.name string Required Name of the runner. Must be between 1 and 64 characters and may only contain upper and lowercase letters a-z, numbers 0-9, '.', '-', and '_'.
body.image object Required The image of runner. To list all available images, use GET /actions/hosted-runners/images/github-owned or GET /actions/hosted-runners/images/partner.
body.image.id string Optional The unique identifier of the runner image.
body.image.source string Optional The source of the runner image. enum: ["github","partner","custom"]
body.image.version string | null Optional The version of the runner image to deploy. This is relevant only for runners using custom images.
body.size string Required The machine size of the runner. To list available sizes, use GET actions/hosted-runners/machine-sizes
body.runner_group_id integer Required The existing runner group to add this runner to.
body.maximum_runners integer Optional The maximum amount of runners to scale up to. Runners will not auto-scale above this number. Use this setting to limit your cost.
body.enable_static_ip boolean Optional Whether this runner should be created with a static public IP. Note limit on account. To list limits on account, use GET actions/hosted-runners/limits
body.image_gen boolean Optional Whether this runner should be used to generate custom images. default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "My Hosted runner",
    "image": {
      "id": "ubuntu-latest",
      "source": "github"
    },
    "runner_group_id": 1,
    "size": "4-core",
    "maximum_runners": 50,
    "enable_static_ip": false
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List custom images for an organization — github.actions.list-custom-images-for-org

Run List custom images for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a custom image definition for GitHub Actions Hosted Runners — github.actions.get-custom-image-for-org

Run Get a custom image definition for GitHub Actions Hosted Runners with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.image_definition_id integer Required Image definition ID of custom image

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "image_definition_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a custom image from the organization — github.actions.delete-custom-image-from-org

Run Delete a custom image from the organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.image_definition_id integer Required Image definition ID of custom image

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "image_definition_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List image versions of a custom image for an organization — github.actions.list-custom-image-versions-for-org

Run List image versions of a custom image for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.image_definition_id integer Required Image definition ID of custom image
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "image_definition_id": 1,
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get GitHub-owned images for GitHub-hosted runners in an organization — github.actions.get-hosted-runners-github-owned-images-for-org

Run Get GitHub-owned images for GitHub-hosted runners in an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get partner images for GitHub-hosted runners in an organization — github.actions.get-hosted-runners-partner-images-for-org

Run Get partner images for GitHub-hosted runners in an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get limits on GitHub-hosted runners for an organization — github.actions.get-hosted-runners-limits-for-org

Run Get limits on GitHub-hosted runners for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get GitHub-hosted runners machine specs for an organization — github.actions.get-hosted-runners-machine-specs-for-org

Run Get GitHub-hosted runners machine specs for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get platforms for GitHub-hosted runners in an organization — github.actions.get-hosted-runners-platforms-for-org

Run Get platforms for GitHub-hosted runners in an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a GitHub-hosted runner for an organization — github.actions.get-hosted-runner-for-org

Run Get a GitHub-hosted runner for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.hosted_runner_id integer Required Unique identifier of the GitHub-hosted runner.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "hosted_runner_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a GitHub-hosted runner for an organization — github.actions.update-hosted-runner-for-org

Run Update a GitHub-hosted runner for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.hosted_runner_id integer Required Unique identifier of the GitHub-hosted runner.
body object Required
body.name string Optional Name of the runner. Must be between 1 and 64 characters and may only contain upper and lowercase letters a-z, numbers 0-9, '.', '-', and '_'.
body.runner_group_id integer Optional The existing runner group to add this runner to.
body.maximum_runners integer Optional The maximum amount of runners to scale up to. Runners will not auto-scale above this number. Use this setting to limit your cost.
body.enable_static_ip boolean Optional Whether this runner should be updated with a static public IP. Note limit on account. To list limits on account, use GET actions/hosted-runners/limits
body.size string Optional The machine size of the runner. To list available sizes, use GET actions/hosted-runners/machine-sizes
body.image_source string Optional The source type of the runner image to use. Must match the source of the image specified by image_id. Can be one of github, partner, or custom. enum: ["github","partner","custom"]
body.image_id string Optional The unique identifier of the runner image. To list available images, use GET /actions/hosted-runners/images/github-owned, GET /actions/hosted-runners/images/partner, or GET /actions/hosted-runners/images/custom.
body.image_version string | null Optional The version of the runner image to deploy. This is relevant only for runners using custom images.
body.image_gen boolean Optional Whether to enable image generation for this runner pool. When enabled, the runner pool is used to build and publish custom runner images.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "hosted_runner_id": 1
  },
  "body": {
    "name": "My larger runner",
    "runner_group_id": 1,
    "maximum_runners": 50,
    "enable_static_ip": false
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a GitHub-hosted runner for an organization — github.actions.delete-hosted-runner-for-org

Run Delete a GitHub-hosted runner for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.hosted_runner_id integer Required Unique identifier of the GitHub-hosted runner.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "hosted_runner_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List OIDC custom property inclusions for an organization — github.oidc.list-oidc-custom-property-inclusions-for-org

Run List OIDC custom property inclusions for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an OIDC custom property inclusion for an organization — github.oidc.create-oidc-custom-property-inclusion-for-org

Run Create an OIDC custom property inclusion for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body — Required $ref: "#/definitions/oidc-custom-property-inclusion-input"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "custom_property_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an OIDC custom property inclusion for an organization — github.oidc.delete-oidc-custom-property-inclusion-for-org

Run Delete an OIDC custom property inclusion for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.custom_property_name string Required The name of the custom property to remove from OIDC token inclusion

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "custom_property_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the customization template for an OIDC subject claim for an organization — github.oidc.get-oidc-custom-sub-template-for-org

Run Get the customization template for an OIDC subject claim for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set the customization template for an OIDC subject claim for an organization — github.oidc.update-oidc-custom-sub-template-for-org

Run Set the customization template for an OIDC subject claim for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required Actions OIDC Subject customization
body.include_claim_keys array Optional Array of unique strings. Each claim key can only contain alphanumeric characters and underscores.
body.include_claim_keys[] string Optional
body.use_immutable_subject boolean Optional Whether to opt in to the immutable OIDC subject claim format for the organization. When true, new OIDC tokens will use a stable, repository-ID-based sub claim instead of the name-based format.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {}
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get GitHub Actions permissions for an organization — github.actions.get-github-actions-permissions-organization

Run Get GitHub Actions permissions for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set GitHub Actions permissions for an organization — github.actions.set-github-actions-permissions-organization

Run Set GitHub Actions permissions for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.enabled_repositories — Required $ref: "#/definitions/enabled-repositories"
body.allowed_actions — Optional $ref: "#/definitions/allowed-actions"
body.sha_pinning_required — Optional $ref: "#/definitions/sha-pinning-required"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "enabled_repositories": "all",
    "allowed_actions": "selected",
    "sha_pinning_required": true
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get artifact and log retention settings for an organization — github.actions.get-artifact-and-log-retention-settings-organization

Run Get artifact and log retention settings for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set artifact and log retention settings for an organization — github.actions.set-artifact-and-log-retention-settings-organization

Run Set artifact and log retention settings for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body — Required $ref: "#/definitions/actions-artifact-and-log-retention"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "days": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get fork PR contributor approval permissions for an organization — github.actions.get-fork-pr-contributor-approval-permissions-organization

Run Get fork PR contributor approval permissions for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set fork PR contributor approval permissions for an organization — github.actions.set-fork-pr-contributor-approval-permissions-organization

Run Set fork PR contributor approval permissions for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body — Required $ref: "#/definitions/actions-fork-pr-contributor-approval"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "approval_policy": "first_time_contributors_new_to_github"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get private repo fork PR workflow settings for an organization — github.actions.get-private-repo-fork-pr-workflows-settings-organization

Run Get private repo fork PR workflow settings for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set private repo fork PR workflow settings for an organization — github.actions.set-private-repo-fork-pr-workflows-settings-organization

Run Set private repo fork PR workflow settings for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body — Required $ref: "#/definitions/actions-fork-pr-workflows-private-repos-request"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "run_workflows_from_fork_pull_requests": false
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List selected repositories enabled for GitHub Actions in an organization — github.actions.list-selected-repositories-enabled-github-actions-organization

Run List selected repositories enabled for GitHub Actions in an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set selected repositories enabled for GitHub Actions in an organization — github.actions.set-selected-repositories-enabled-github-actions-organization

Run Set selected repositories enabled for GitHub Actions in an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.selected_repository_ids array Required List of repository IDs to enable for GitHub Actions.
body.selected_repository_ids[] integer Optional Unique identifier of the repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "selected_repository_ids": [
      32,
      42
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Enable a selected repository for GitHub Actions in an organization — github.actions.enable-selected-repository-github-actions-organization

Run Enable a selected repository for GitHub Actions in an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.repository_id integer Required The unique identifier of the repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Disable a selected repository for GitHub Actions in an organization — github.actions.disable-selected-repository-github-actions-organization

Run Disable a selected repository for GitHub Actions in an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.repository_id integer Required The unique identifier of the repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get allowed actions and reusable workflows for an organization — github.actions.get-allowed-actions-organization

Run Get allowed actions and reusable workflows for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set allowed actions and reusable workflows for an organization — github.actions.set-allowed-actions-organization

Run Set allowed actions and reusable workflows for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body — Optional $ref: "#/definitions/selected-actions"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get self-hosted runners settings for an organization — github.actions.get-self-hosted-runners-permissions-organization

Run Get self-hosted runners settings for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set self-hosted runners settings for an organization — github.actions.set-self-hosted-runners-permissions-organization

Run Set self-hosted runners settings for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.enabled_repositories string Required The policy that controls whether self-hosted runners can be used in the organization enum: ["all","selected","none"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "enabled_repositories": "all"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repositories allowed to use self-hosted runners in an organization — github.actions.list-selected-repositories-self-hosted-runners-organization

Run List repositories allowed to use self-hosted runners in an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set repositories allowed to use self-hosted runners in an organization — github.actions.set-selected-repositories-self-hosted-runners-organization

Run Set repositories allowed to use self-hosted runners in an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.selected_repository_ids array Required IDs of repositories that can use repository-level self-hosted runners
body.selected_repository_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "selected_repository_ids": [
      1,
      2,
      3
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add a repository to the list of repositories allowed to use self-hosted runners in an organization — github.actions.enable-selected-repository-self-hosted-runners-organization

Run Add a repository to the list of repositories allowed to use self-hosted runners in an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.repository_id integer Required The unique identifier of the repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove a repository from the list of repositories allowed to use self-hosted runners in an organization — github.actions.disable-selected-repository-self-hosted-runners-organization

Run Remove a repository from the list of repositories allowed to use self-hosted runners in an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.repository_id integer Required The unique identifier of the repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get default workflow permissions for an organization — github.actions.get-github-actions-default-workflow-permissions-organization

Run Get default workflow permissions for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set default workflow permissions for an organization — github.actions.set-github-actions-default-workflow-permissions-organization

Run Set default workflow permissions for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body — Optional $ref: "#/definitions/actions-set-default-workflow-permissions"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization Actions policies — github.actions.get-org-actions-policies

Run List organization Actions policies with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.has_parents boolean Optional Include policies configured at higher levels that apply to this organization default: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an organization Actions policy — github.actions.create-org-actions-policy

Run Create an organization Actions policy with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.name string Required The name of the policy.
body.enforcement — Required $ref: "#/definitions/repository-rule-enforcement"
body.conditions — Optional $ref: "#/definitions/actions-policy-org-conditions"
body.rules array Optional An array of rules within the policy.
body.rules[] — Optional $ref: "#/definitions/actions-rule"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "Require approved actors",
    "enforcement": "active",
    "rules": [
      {
        "type": "restrict_actions_actors",
        "parameters": {
          "allowed_actors": [
            {
              "id": 1234,
              "type": "Team"
            }
          ]
        }
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization Actions policy — github.actions.get-org-actions-policy

Run Get an organization Actions policy with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.policy_id integer Required The ID of the policy.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "policy_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update an organization Actions policy — github.actions.update-org-actions-policy

Run Update an organization Actions policy with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.policy_id integer Required The ID of the policy.
body object Required
body.name string Optional The name of the policy.
body.enforcement — Optional $ref: "#/definitions/repository-rule-enforcement"
body.conditions — Optional $ref: "#/definitions/actions-policy-org-conditions"
body.rules array Optional An array of rules within the policy.
body.rules[] — Optional $ref: "#/definitions/actions-rule"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "policy_id": 1
  },
  "body": {
    "name": "Updated policy name",
    "enforcement": "active"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an organization Actions policy — github.actions.delete-org-actions-policy

Run Delete an organization Actions policy with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.policy_id integer Required The ID of the policy.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "policy_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List self-hosted runner groups for an organization — github.actions.list-self-hosted-runner-groups-for-org

Run List self-hosted runner groups for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.visible_to_repository string Optional Only return runner groups that are allowed to be used by this repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a self-hosted runner group for an organization — github.actions.create-self-hosted-runner-group-for-org

Run Create a self-hosted runner group for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.name string Required Name of the runner group.
body.visibility string Optional Visibility of a runner group. You can select all repositories, select individual repositories, or limit access to private repositories. enum: ["selected","all","private"]; default: "all"
body.selected_repository_ids array Optional List of repository IDs that can access the runner group.
body.selected_repository_ids[] integer Optional Unique identifier of the repository.
body.runners array Optional List of runner IDs to add to the runner group.
body.runners[] integer Optional Unique identifier of the runner.
body.allows_public_repositories boolean Optional Whether the runner group can be used by public repositories. default: false
body.restricted_to_workflows boolean Optional If true, the runner group will be restricted to running only the workflows specified in the selected_workflows array. default: false
body.selected_workflows array Optional List of workflows the runner group should be allowed to run. This setting will be ignored unless restricted_to_workflows is set to true.
body.selected_workflows[] string Optional Name of workflow the runner group should be allowed to run. Note that a ref, tag, or long SHA is required.
body.network_configuration_id string Optional The identifier of a hosted compute network configuration.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "Expensive hardware runners",
    "visibility": "selected",
    "selected_repository_ids": [
      32,
      91
    ],
    "runners": [
      9,
      2
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a self-hosted runner group for an organization — github.actions.get-self-hosted-runner-group-for-org

Run Get a self-hosted runner group for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_group_id integer Required Unique identifier of the self-hosted runner group.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_group_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a self-hosted runner group for an organization — github.actions.update-self-hosted-runner-group-for-org

Run Update a self-hosted runner group for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_group_id integer Required Unique identifier of the self-hosted runner group.
body object Required
body.name string Required Name of the runner group.
body.visibility string Optional Visibility of a runner group. You can select all repositories, select individual repositories, or all private repositories. enum: ["selected","all","private"]
body.allows_public_repositories boolean Optional Whether the runner group can be used by public repositories. default: false
body.restricted_to_workflows boolean Optional If true, the runner group will be restricted to running only the workflows specified in the selected_workflows array. default: false
body.selected_workflows array Optional List of workflows the runner group should be allowed to run. This setting will be ignored unless restricted_to_workflows is set to true.
body.selected_workflows[] string Optional Name of workflow the runner group should be allowed to run. Note that a ref, tag, or long SHA is required.
body.network_configuration_id string | null Optional The identifier of a hosted compute network configuration.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_group_id": 1
  },
  "body": {
    "name": "Expensive hardware runners",
    "visibility": "selected"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a self-hosted runner group from an organization — github.actions.delete-self-hosted-runner-group-from-org

Run Delete a self-hosted runner group from an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_group_id integer Required Unique identifier of the self-hosted runner group.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_group_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List GitHub-hosted runners in a group for an organization — github.actions.list-github-hosted-runners-in-group-for-org

Run List GitHub-hosted runners in a group for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_group_id integer Required Unique identifier of the self-hosted runner group.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_group_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository access to a self-hosted runner group in an organization — github.actions.list-repo-access-to-self-hosted-runner-group-in-org

Run List repository access to a self-hosted runner group in an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_group_id integer Required Unique identifier of the self-hosted runner group.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_group_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set repository access for a self-hosted runner group in an organization — github.actions.set-repo-access-to-self-hosted-runner-group-in-org

Run Set repository access for a self-hosted runner group in an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_group_id integer Required Unique identifier of the self-hosted runner group.
body object Required
body.selected_repository_ids array Required List of repository IDs that can access the runner group.
body.selected_repository_ids[] integer Optional Unique identifier of the repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_group_id": 1
  },
  "body": {
    "selected_repository_ids": [
      32,
      91
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add repository access to a self-hosted runner group in an organization — github.actions.add-repo-access-to-self-hosted-runner-group-in-org

Run Add repository access to a self-hosted runner group in an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_group_id integer Required Unique identifier of the self-hosted runner group.
path.repository_id integer Required The unique identifier of the repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_group_id": 1,
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove repository access to a self-hosted runner group in an organization — github.actions.remove-repo-access-to-self-hosted-runner-group-in-org

Run Remove repository access to a self-hosted runner group in an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_group_id integer Required Unique identifier of the self-hosted runner group.
path.repository_id integer Required The unique identifier of the repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_group_id": 1,
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List self-hosted runners in a group for an organization — github.actions.list-self-hosted-runners-in-group-for-org

Run List self-hosted runners in a group for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_group_id integer Required Unique identifier of the self-hosted runner group.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_group_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set self-hosted runners in a group for an organization — github.actions.set-self-hosted-runners-in-group-for-org

Run Set self-hosted runners in a group for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_group_id integer Required Unique identifier of the self-hosted runner group.
body object Required
body.runners array Required List of runner IDs to add to the runner group.
body.runners[] integer Optional Unique identifier of the runner.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_group_id": 1
  },
  "body": {
    "runners": [
      9,
      2
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add a self-hosted runner to a group for an organization — github.actions.add-self-hosted-runner-to-group-for-org

Run Add a self-hosted runner to a group for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_group_id integer Required Unique identifier of the self-hosted runner group.
path.runner_id integer Required Unique identifier of the self-hosted runner.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_group_id": 1,
    "runner_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove a self-hosted runner from a group for an organization — github.actions.remove-self-hosted-runner-from-group-for-org

Run Remove a self-hosted runner from a group for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_group_id integer Required Unique identifier of the self-hosted runner group.
path.runner_id integer Required Unique identifier of the self-hosted runner.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_group_id": 1,
    "runner_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List self-hosted runners for an organization — github.actions.list-self-hosted-runners-for-org

Run List self-hosted runners for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.name string Optional The name of a self-hosted runner.
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get runner version end-of-life schedule for an organization — github.actions.get-runner-version-deprecation-for-org

Run Get runner version end-of-life schedule for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.version string Required The runner version to look up.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "version": "2.328.0"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List runner applications for an organization — github.actions.list-runner-applications-for-org

Run List runner applications for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create configuration for a just-in-time runner for an organization — github.actions.generate-runner-jitconfig-for-org

Run Create configuration for a just-in-time runner for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.name string Required The name of the new runner.
body.runner_group_id integer Required The ID of the runner group to register the runner to.
body.labels array Required The names of the custom labels to add to the runner. Minimum items: 1. Maximum items: 100. minItems: 1; maxItems: 100
body.labels[] string Optional
body.work_folder string Optional The working directory to be used for job execution, relative to the runner install directory. default: "_work"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "New runner",
    "runner_group_id": 1,
    "labels": [
      "self-hosted",
      "X64",
      "macOS",
      "no-gpu"
    ],
    "work_folder": "_work"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a registration token for an organization — github.actions.create-registration-token-for-org

Run Create a registration token for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a remove token for an organization — github.actions.create-remove-token-for-org

Run Create a remove token for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a self-hosted runner for an organization — github.actions.get-self-hosted-runner-for-org

Run Get a self-hosted runner for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_id integer Required Unique identifier of the self-hosted runner.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a self-hosted runner from an organization — github.actions.delete-self-hosted-runner-from-org

Run Delete a self-hosted runner from an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_id integer Required Unique identifier of the self-hosted runner.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List labels for a self-hosted runner for an organization — github.actions.list-labels-for-self-hosted-runner-for-org

Run List labels for a self-hosted runner for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_id integer Required Unique identifier of the self-hosted runner.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add custom labels to a self-hosted runner for an organization — github.actions.add-custom-labels-to-self-hosted-runner-for-org

Run Add custom labels to a self-hosted runner for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_id integer Required Unique identifier of the self-hosted runner.
body object Required
body.labels array Required The names of the custom labels to add to the runner. minItems: 1; maxItems: 100
body.labels[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_id": 1
  },
  "body": {
    "labels": [
      "gpu",
      "accelerated"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set custom labels for a self-hosted runner for an organization — github.actions.set-custom-labels-for-self-hosted-runner-for-org

Run Set custom labels for a self-hosted runner for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_id integer Required Unique identifier of the self-hosted runner.
body object Required
body.labels array Required The names of the custom labels to set for the runner. You can pass an empty array to remove all custom labels. minItems: 0; maxItems: 100
body.labels[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_id": 1
  },
  "body": {
    "labels": [
      "gpu",
      "accelerated"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove all custom labels from a self-hosted runner for an organization — github.actions.remove-all-custom-labels-from-self-hosted-runner-for-org

Run Remove all custom labels from a self-hosted runner for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_id integer Required Unique identifier of the self-hosted runner.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove a custom label from a self-hosted runner for an organization — github.actions.remove-custom-label-from-self-hosted-runner-for-org

Run Remove a custom label from a self-hosted runner for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.runner_id integer Required Unique identifier of the self-hosted runner.
path.name string Required The name of a self-hosted runner's custom label.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "runner_id": 1,
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization secrets — github.actions.list-org-secrets

Run List organization secrets with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization public key — github.actions.get-org-public-key

Run Get an organization public key with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization secret — github.actions.get-org-secret

Run Get an organization secret with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update an organization secret — github.actions.create-or-update-org-secret

Run Create or update an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
body object Required
body.encrypted_value string Required Value for your secret, encrypted with LibSodium using the public key retrieved from the Get an organization public key endpoint. pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$"
body.key_id string Required ID of the key you used to encrypt the secret.
body.visibility string Required Which type of organization repositories have access to the organization secret. selected means only the repositories specified by selected_repository_ids can access the secret. enum: ["all","private","selected"]
body.selected_repository_ids array Optional An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints.
body.selected_repository_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  },
  "body": {
    "encrypted_value": "c2VjcmV0",
    "key_id": "012345678912345678",
    "visibility": "selected",
    "selected_repository_ids": [
      1296269,
      1296280
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an organization secret — github.actions.delete-org-secret

Run Delete an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List selected repositories for an organization secret — github.actions.list-selected-repos-for-org-secret

Run List selected repositories for an organization secret with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set selected repositories for an organization secret — github.actions.set-selected-repos-for-org-secret

Run Set selected repositories for an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
body object Required
body.selected_repository_ids array Required An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can add and remove individual repositories using the Add selected repository to an organization secret and Remove selected repository from an organization secret endpoints.
body.selected_repository_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  },
  "body": {
    "selected_repository_ids": [
      64780797
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add selected repository to an organization secret — github.actions.add-selected-repo-to-org-secret

Run Add selected repository to an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
path.repository_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove selected repository from an organization secret — github.actions.remove-selected-repo-from-org-secret

Run Remove selected repository from an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
path.repository_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization variables — github.actions.list-org-variables

Run List organization variables with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 30). For more information, see "Using pagination in the REST API." default: 10
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an organization variable — github.actions.create-org-variable

Run Create an organization variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.name string Required The name of the variable.
body.value string Required The value of the variable.
body.visibility string Required The type of repositories in the organization that can access the variable. selected means only the repositories specified by selected_repository_ids can access the variable. enum: ["all","private","selected"]
body.selected_repository_ids array Optional An array of repository ids that can access the organization variable. You can only provide a list of repository ids when the visibility is set to selected.
body.selected_repository_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "USERNAME",
    "value": "octocat",
    "visibility": "selected",
    "selected_repository_ids": [
      1296269,
      1296280
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization variable — github.actions.get-org-variable

Run Get an organization variable with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.name string Required The name of the variable.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update an organization variable — github.actions.update-org-variable

Run Update an organization variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.name string Required The name of the variable.
body object Required
body.name string Optional The name of the variable.
body.value string Optional The value of the variable.
body.visibility string Optional The type of repositories in the organization that can access the variable. selected means only the repositories specified by selected_repository_ids can access the variable. enum: ["all","private","selected"]
body.selected_repository_ids array Optional An array of repository ids that can access the organization variable. You can only provide a list of repository ids when the visibility is set to selected.
body.selected_repository_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "name": "example"
  },
  "body": {
    "name": "USERNAME",
    "value": "octocat",
    "visibility": "selected",
    "selected_repository_ids": [
      1296269,
      1296280
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an organization variable — github.actions.delete-org-variable

Run Delete an organization variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.name string Required The name of the variable.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List selected repositories for an organization variable — github.actions.list-selected-repos-for-org-variable

Run List selected repositories for an organization variable with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.name string Required The name of the variable.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set selected repositories for an organization variable — github.actions.set-selected-repos-for-org-variable

Run Set selected repositories for an organization variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.name string Required The name of the variable.
body object Required
body.selected_repository_ids array Required The IDs of the repositories that can access the organization variable.
body.selected_repository_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "name": "example"
  },
  "body": {
    "selected_repository_ids": [
      64780797
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add selected repository to an organization variable — github.actions.add-selected-repo-to-org-variable

Run Add selected repository to an organization variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.name string Required The name of the variable.
path.repository_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "name": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove selected repository from an organization variable — github.actions.remove-selected-repo-from-org-variable

Run Remove selected repository from an organization variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.name string Required The name of the variable.
path.repository_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "name": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization secrets — github.agents.list-org-secrets

Run List organization secrets with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization public key — github.agents.get-org-public-key

Run Get an organization public key with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization secret — github.agents.get-org-secret

Run Get an organization secret with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update an organization secret — github.agents.create-or-update-org-secret

Run Create or update an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
body object Required
body.encrypted_value string Required Value for your secret, encrypted with LibSodium using the public key retrieved from the Get an organization public key endpoint. pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$"
body.key_id string Required ID of the key you used to encrypt the secret.
body.visibility string Required Which type of organization repositories have access to the organization secret. selected means only the repositories specified by selected_repository_ids can access the secret. enum: ["all","private","selected"]
body.selected_repository_ids array Optional An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints.
body.selected_repository_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  },
  "body": {
    "encrypted_value": "c2VjcmV0",
    "key_id": "012345678912345678",
    "visibility": "selected",
    "selected_repository_ids": [
      1296269,
      1296280
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an organization secret — github.agents.delete-org-secret

Run Delete an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List selected repositories for an organization secret — github.agents.list-selected-repos-for-org-secret

Run List selected repositories for an organization secret with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set selected repositories for an organization secret — github.agents.set-selected-repos-for-org-secret

Run Set selected repositories for an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
body object Required
body.selected_repository_ids array Required An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can add and remove individual repositories using the Add selected repository to an organization secret and Remove selected repository from an organization secret endpoints.
body.selected_repository_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  },
  "body": {
    "selected_repository_ids": [
      64780797
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add selected repository to an organization secret — github.agents.add-selected-repo-to-org-secret

Run Add selected repository to an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
path.repository_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove selected repository from an organization secret — github.agents.remove-selected-repo-from-org-secret

Run Remove selected repository from an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
path.repository_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization variables — github.agents.list-org-variables

Run List organization variables with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 30). For more information, see "Using pagination in the REST API." default: 10
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an organization variable — github.agents.create-org-variable

Run Create an organization variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.name string Required The name of the variable.
body.value string Required The value of the variable.
body.visibility string Required The type of repositories in the organization that can access the variable. selected means only the repositories specified by selected_repository_ids can access the variable. enum: ["all","private","selected"]
body.selected_repository_ids array Optional An array of repository ids that can access the organization variable. You can only provide a list of repository ids when the visibility is set to selected.
body.selected_repository_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "USERNAME",
    "value": "octocat",
    "visibility": "selected",
    "selected_repository_ids": [
      1296269,
      1296280
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization variable — github.agents.get-org-variable

Run Get an organization variable with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.name string Required The name of the variable.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update an organization variable — github.agents.update-org-variable

Run Update an organization variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.name string Required The name of the variable.
body object Required
body.name string Optional The name of the variable.
body.value string Optional The value of the variable.
body.visibility string Optional The type of repositories in the organization that can access the variable. selected means only the repositories specified by selected_repository_ids can access the variable. enum: ["all","private","selected"]
body.selected_repository_ids array Optional An array of repository ids that can access the organization variable. You can only provide a list of repository ids when the visibility is set to selected.
body.selected_repository_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "name": "example"
  },
  "body": {
    "name": "USERNAME",
    "value": "octocat",
    "visibility": "selected",
    "selected_repository_ids": [
      1296269,
      1296280
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an organization variable — github.agents.delete-org-variable

Run Delete an organization variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.name string Required The name of the variable.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List selected repositories for an organization variable — github.agents.list-selected-repos-for-org-variable

Run List selected repositories for an organization variable with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.name string Required The name of the variable.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set selected repositories for an organization variable — github.agents.set-selected-repos-for-org-variable

Run Set selected repositories for an organization variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.name string Required The name of the variable.
body object Required
body.selected_repository_ids array Required The IDs of the repositories that can access the organization variable.
body.selected_repository_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "name": "example"
  },
  "body": {
    "selected_repository_ids": [
      64780797
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add selected repository to an organization variable — github.agents.add-selected-repo-to-org-variable

Run Add selected repository to an organization variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.name string Required The name of the variable.
path.repository_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "name": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove selected repository from an organization variable — github.agents.remove-selected-repo-from-org-variable

Run Remove selected repository from an organization variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.name string Required The name of the variable.
path.repository_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "name": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an artifact deployment record — github.orgs.create-artifact-deployment-record

Run Create an artifact deployment record with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.name string Required The name of the artifact. minLength: 1; maxLength: 256
body.digest string Required The hex encoded digest of the artifact. minLength: 71; maxLength: 71; pattern: "^sha256:[a-f0-9]{64}$"
body.version string Optional The artifact version. minLength: 1; maxLength: 100
body.status string Required The status of the artifact. Can be either deployed or decommissioned. enum: ["deployed","decommissioned"]
body.logical_environment string Required The stage of the deployment. minLength: 1; maxLength: 128
body.physical_environment string Optional The physical region of the deployment. maxLength: 128
body.cluster string Optional The deployment cluster. maxLength: 128
body.deployment_name string Required The unique identifier for the deployment represented by the new record. To accommodate differing containers and namespaces within a cluster, the following format is recommended: {namespaceName}-{deploymentName}-{containerName}. maxLength: 256
body.tags object Optional The tags associated with the deployment. maxProperties: 5; additionalProperties: {"type":"string"}
body.runtime_risks array Optional A list of runtime risks associated with the deployment. maxItems: 4; uniqueItems: true
body.runtime_risks[] string Optional enum: ["critical-resource","internet-exposed","lateral-movement","sensitive-data"]
body.github_repository string Optional The name of the GitHub repository associated with the artifact. This should be used when there are no provenance attestations available for the artifact. The repository must belong to the organization specified in the path parameter. If a provenance attestation is available for the artifact, the API will use the repository information from the attestation instead of this parameter. minLength: 1; maxLength: 100; pattern: "^[A-Za-z0-9.\\-_]+$"
body.return_records boolean Optional If true, the endpoint will return the created or updated record in the response body. default: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "awesome-image",
    "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72",
    "status": "deployed",
    "logical_environment": "prod",
    "physical_environment": "pacific-east",
    "cluster": "moda-1",
    "deployment_name": "deployment-pod",
    "tags": {
      "data-access": "sensitive"
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set cluster deployment records — github.orgs.set-cluster-deployment-records

Run Set cluster deployment records with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.cluster string Required The cluster name. minLength: 1; maxLength: 128; pattern: "^[a-zA-Z0-9._-]+$"
body object Required
body.logical_environment string Required The stage of the deployment. minLength: 1; maxLength: 128
body.physical_environment string Optional The physical region of the deployment. maxLength: 128
body.deployments array Required The list of deployments to record. maxItems: 1000
body.deployments[] object Optional
body.deployments[].name string Required The name of the artifact. minLength: 1; maxLength: 256
body.deployments[].digest string Required The hex encoded digest of the artifact. minLength: 71; maxLength: 71; pattern: "^sha256:[a-f0-9]{64}$"
body.deployments[].version string Optional The artifact version. maxLength: 100
body.deployments[].status string Optional The deployment status of the artifact. enum: ["deployed","decommissioned"]; default: "deployed"
body.deployments[].deployment_name string Required The unique identifier for the deployment represented by the new record. To accommodate differing containers and namespaces within a record set, the following format is recommended: {namespaceName}-{deploymentName}-{containerName}. The deployment_name must be unique across all entries in the deployments array. minLength: 1; maxLength: 256
body.deployments[].github_repository string Optional The name of the GitHub repository associated with the artifact. This should be used when there are no provenance attestations available for the artifact. The repository must belong to the organization specified in the path parameter. If a provenance attestation is available for the artifact, the API will use the repository information from the attestation instead of this parameter. maxLength: 100; pattern: "^[A-Za-z0-9.\\-_]+$"
body.deployments[].tags object Optional Key-value pairs to tag the deployment record. additionalProperties: {"type":"string"}
body.deployments[].runtime_risks array Optional A list of runtime risks associated with the deployment. maxItems: 4; uniqueItems: true
body.deployments[].runtime_risks[] string Optional enum: ["critical-resource","internet-exposed","lateral-movement","sensitive-data"]
body.partial_success boolean Optional When enabled, deployments associated with repositories the actor can write to are processed while deployments associated with repositories that cannot be resolved or written to by the actor are skipped and reported in the errors array. When false (the default), the endpoint returns an error if any targeted repository cannot be resolved, the actor lacks write access, or no matching attestation can be found. default: false
body.return_records boolean Optional If true, the endpoint will return the set records in the response body default: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "cluster": "example"
  },
  "body": {
    "logical_environment": "prod",
    "physical_environment": "pacific-east",
    "deployments": [
      {
        "name": "awesome-image",
        "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72",
        "version": "2.1.0",
        "status": "deployed",
        "deployment_name": "deployment-pod",
        "tags": {
          "owning-team": "platform"
        },
        "runtime_risks": [
          "sensitive-data"
        ]
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a cluster deployment records job — github.orgs.create-cluster-deployment-records-job

Run Create a cluster deployment records job with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.cluster string Required The cluster name. minLength: 1; maxLength: 128; pattern: "^[a-zA-Z0-9._-]+$"
body object Required
body.logical_environment string Required The stage of the deployment. minLength: 1; maxLength: 128
body.physical_environment string Optional The physical region of the deployment. maxLength: 128
body.deployments array Required The list of deployments to record. maxItems: 5000
body.deployments[] object Optional
body.deployments[].name string Required The name of the artifact. minLength: 1; maxLength: 256
body.deployments[].digest string Required The hex encoded digest of the artifact. minLength: 71; maxLength: 71; pattern: "^sha256:[a-f0-9]{64}$"
body.deployments[].version string Optional The artifact version. maxLength: 100
body.deployments[].status string Optional The deployment status of the artifact. enum: ["deployed","decommissioned"]; default: "deployed"
body.deployments[].deployment_name string Required The unique identifier for the deployment represented by the new record. minLength: 1; maxLength: 256
body.deployments[].github_repository string Optional The name of the GitHub repository associated with the artifact. maxLength: 100; pattern: "^[A-Za-z0-9.\\-_]+$"
body.deployments[].tags object Optional Key-value pairs to tag the deployment record. additionalProperties: {"type":"string"}
body.deployments[].runtime_risks array Optional A list of runtime risks associated with the deployment. maxItems: 4; uniqueItems: true
body.deployments[].runtime_risks[] string Optional enum: ["critical-resource","internet-exposed","lateral-movement","sensitive-data"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "cluster": "example"
  },
  "body": {
    "logical_environment": "prod",
    "physical_environment": "pacific-east",
    "deployments": [
      {
        "name": "awesome-image",
        "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72",
        "version": "2.1.0",
        "status": "deployed",
        "deployment_name": "deployment-pod",
        "tags": {
          "owning-team": "platform"
        },
        "runtime_risks": [
          "sensitive-data"
        ]
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get cluster deployment records job status — github.orgs.get-cluster-deployment-records-job

Run Get cluster deployment records job status with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.cluster string Required The cluster name. minLength: 1; maxLength: 128; pattern: "^[a-zA-Z0-9._-]+$"
path.job_id integer Required The ID of the job.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "cluster": "example",
    "job_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create artifact metadata storage record — github.orgs.create-artifact-storage-record

Run Create artifact metadata storage record with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.name string Required The name of the artifact. minLength: 1; maxLength: 256
body.digest string Required The digest of the artifact (algorithm:hex-encoded-digest). minLength: 71; maxLength: 71; pattern: "^sha256:[a-f0-9]{64}$"
body.version string Optional The artifact version. minLength: 1; maxLength: 100
body.artifact_url string Optional The URL where the artifact is stored. maxLength: 152; pattern: "^https://"; format: "uri"
body.path string Optional The path of the artifact. maxLength: 512; format: "uri"
body.registry_url string Required The base URL of the artifact registry. minLength: 1; maxLength: 256; pattern: "^https://"; format: "uri"
body.repository string Optional The repository name within the registry. maxLength: 128
body.status string Optional The status of the artifact (e.g., active, inactive). enum: ["active","eol","deleted"]; default: "active"
body.github_repository string Optional The name of the GitHub repository associated with the artifact. This should be used when there are no provenance attestations available for the artifact. The repository must belong to the organization specified in the path parameter. If a provenance attestation is available for the artifact, the API will use the repository information from the attestation instead of this parameter. minLength: 1; maxLength: 100; pattern: "^[A-Za-z0-9.\\-_]+$"
body.return_records boolean Optional If true, the endpoint will return the created record in the response body. default: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "libfoo",
    "version": "1.2.3",
    "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72",
    "artifact_url": "https://reg.example.com/artifactory/bar/libfoo-1.2.3",
    "registry_url": "https://reg.example.com/artifactory/",
    "repository": "bar",
    "status": "active"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List artifact storage records — github.orgs.list-artifact-storage-records

Run List artifact storage records with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.subject_digest string Required The parameter should be set to the attestation's subject's SHA256 digest, in the form sha256:HEX_DIGEST. minLength: 71; maxLength: 71; pattern: "^sha256:[a-f0-9]{64}$"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "subject_digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List attestations by bulk subject digests — github.orgs.list-attestations-bulk

Run List attestations by bulk subject digests with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.subject_digests array Required List of subject digests to fetch attestations for. minItems: 1; maxItems: 1024
body.subject_digests[] string Optional
body.predicate_type string Optional Optional filter for fetching attestations with a given predicate type. This option accepts provenance, sbom, release, or freeform text for custom predicate types.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "subject_digests": [
      "example"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete attestations in bulk — github.orgs.delete-attestations-bulk

Run Delete attestations in bulk with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required The request body must include either subject_digests or attestation_ids, but not both.
body object Required oneOf[1]
body.subject_digests array Required List of subject digests associated with the artifact attestations to delete. oneOf[1]; minItems: 1; maxItems: 1024
body.subject_digests[] string Optional oneOf[1]
body object Required oneOf[2]
body.attestation_ids array Required List of unique IDs associated with the artifact attestations to delete. oneOf[2]; minItems: 1; maxItems: 1024
body.attestation_ids[] integer Optional oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "subject_digests": [
      "sha256:abc123",
      "sha512:def456"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete attestations by subject digest — github.orgs.delete-attestations-by-subject-digest

Run Delete attestations by subject digest with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.subject_digest string Required Subject Digest

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "subject_digest": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List attestation repositories — github.orgs.list-attestation-repositories

Run List attestation repositories with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.predicate_type string Optional Optional filter for fetching attestations with a given predicate type. This option accepts provenance, sbom, release, or freeform text for custom predicate types.
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete attestations by ID — github.orgs.delete-attestations-by-id

Run Delete attestations by ID with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.attestation_id integer Required Attestation ID

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "attestation_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List attestations — github.orgs.list-attestations

Run List attestations with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.predicate_type string Optional Optional filter for fetching attestations with a given predicate type. This option accepts provenance, sbom, release, or freeform text for custom predicate types.
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.subject_digest string Required The parameter should be set to the attestation's subject's SHA256 digest, in the form sha256:HEX_DIGEST.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "subject_digest": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List users blocked by an organization — github.orgs.list-blocked-users

Run List users blocked by an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check if a user is blocked by an organization — github.orgs.check-blocked-user

Run Check if a user is blocked by an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Block a user from an organization — github.orgs.block-user

Run Block a user from an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Unblock a user from an organization — github.orgs.unblock-user

Run Unblock a user from an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List campaigns for an organization — github.campaigns.list-org-campaigns

Run List campaigns for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.state — Optional If specified, only campaigns with this state will be returned. $ref: "#/definitions/campaign-state"
query.sort string Optional The property by which to sort the results. enum: ["created","updated","ends_at","published"]; default: "created"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a campaign for an organization — github.campaigns.create-campaign

Run Create a campaign for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required additionalProperties: false
body.name string Required The name of the campaign minLength: 1; maxLength: 50
body.description string Required A description for the campaign minLength: 1; maxLength: 255
body.managers array Optional The logins of the users to set as the campaign managers. At this time, only a single manager can be supplied. maxItems: 10
body.managers[] string Optional The login of each manager
body.team_managers array Optional The slugs of the teams to set as the campaign managers. maxItems: 10
body.team_managers[] string Optional The slug of each team
body.ends_at string Required The end date and time of the campaign. The date must be in the future. format: "date-time"
body.contact_link string | null Optional The contact link of the campaign. Must be a URI. format: "uri"
body.code_scanning_alerts array | null Optional The code scanning alerts to include in this campaign minItems: 1
body.code_scanning_alerts[] object Optional additionalProperties: false
body.code_scanning_alerts[].repository_id integer Required The repository id
body.code_scanning_alerts[].alert_numbers array Required The alert numbers minItems: 1
body.code_scanning_alerts[].alert_numbers[] integer Optional
body.generate_issues boolean Optional If true, will automatically generate issues for the campaign. The default is false. default: false
body — Required oneOf[1]
body — Required oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "Critical CodeQL alerts",
    "description": "Address critical alerts before they are exploited to prevent breaches, protect sensitive data, and mitigate financial and reputational damage.",
    "managers": [
      "octocat"
    ],
    "ends_at": "2024-03-14T00:00:00Z",
    "code_scanning_alerts": [
      {
        "repository_id": 1296269,
        "alert_numbers": [
          1,
          2
        ]
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a campaign for an organization — github.campaigns.get-campaign-summary

Run Get a campaign for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.campaign_number integer Required The campaign number.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "campaign_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a campaign — github.campaigns.update-campaign

Run Update a campaign with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.campaign_number integer Required The campaign number.
body object Required additionalProperties: false
body.name string Optional The name of the campaign minLength: 1; maxLength: 50
body.description string Optional A description for the campaign minLength: 1; maxLength: 255
body.managers array Optional The logins of the users to set as the campaign managers. At this time, only a single manager can be supplied. maxItems: 10
body.managers[] string Optional
body.team_managers array Optional The slugs of the teams to set as the campaign managers. maxItems: 10
body.team_managers[] string Optional The slug of each team
body.ends_at string Optional The end date and time of the campaign, in ISO 8601 format':' YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
body.contact_link string | null Optional The contact link of the campaign. Must be a URI. format: "uri"
body.state — Optional $ref: "#/definitions/campaign-state"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "campaign_number": 1
  },
  "body": {
    "name": "Critical CodeQL alerts"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a campaign for an organization — github.campaigns.delete-campaign

Run Delete a campaign for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.campaign_number integer Required The campaign number.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "campaign_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the AI Scan setting for an organization — github.code-scanning.get-ai-scan-enablement-for-org

Run Get the AI Scan setting for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List code scanning alerts for an organization — github.code-scanning.list-alerts-for-org

Run List code scanning alerts for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.tool_name — Optional The name of a code scanning tool. Only results by this tool will be listed. You can specify the tool by using either tool_name or tool_guid, but not both. $ref: "#/definitions/code-scanning-analysis-tool-name"
query.tool_guid — Optional The GUID of a code scanning tool. Only results by this tool will be listed. Note that some code scanning tools may not include a GUID in their analysis data. You can specify the tool by using either tool_guid or tool_name, but not both. $ref: "#/definitions/code-scanning-analysis-tool-guid"
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.state — Optional If specified, only code scanning alerts with this state will be returned. $ref: "#/definitions/code-scanning-alert-state-query"
query.sort string Optional The property by which to sort the results. enum: ["created","updated"]; default: "created"
query.severity — Optional If specified, only code scanning alerts with this severity will be returned. $ref: "#/definitions/code-scanning-alert-severity"
query.assignees string Optional Filter alerts by assignees. Provide a comma-separated list of user handles (e.g., octocat or octocat,hubot). Use * to list alerts with at least one assignee or none to list alerts with no assignees.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get code security configurations for an organization — github.code-security.get-configurations-for-org

Run Get code security configurations for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.target_type string Optional The target type of the code security configuration enum: ["global","all"]; default: "all"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a code security configuration — github.code-security.create-configuration

Run Create a code security configuration with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required additionalProperties: false
body.name string Required The name of the code security configuration. Must be unique within the organization.
body.description string Optional A description of the code security configuration maxLength: 255
body.advanced_security string Optional The enablement status of GitHub Advanced Security features. enabled will enable both Code Security and Secret Protection features. > [!WARNING] > code_security and secret_protection are deprecated values for this field. Prefer the individual code_security and secret_protection fields to set the status of these features. enum: ["enabled","disabled","code_security","secret_protection"]; default: "disabled"
body.code_security string Optional The enablement status of GitHub Code Security features. enum: ["enabled","disabled","not_set"]
body.dependency_graph string Optional The enablement status of Dependency Graph enum: ["enabled","disabled","not_set"]; default: "enabled"
body.dependency_graph_autosubmit_action string Optional The enablement status of Automatic dependency submission enum: ["enabled","disabled","not_set"]; default: "disabled"
body.dependency_graph_autosubmit_action_options object Optional Feature options for Automatic dependency submission
body.dependency_graph_autosubmit_action_options.labeled_runners boolean Optional Whether to use runners labeled with 'dependency-submission' or standard GitHub runners. default: false
body.dependabot_alerts string Optional The enablement status of Dependabot alerts enum: ["enabled","disabled","not_set"]; default: "disabled"
body.dependabot_reachability string Optional The enablement status of reachability analysis for Dependabot. Only available for organizations with access to reachability analysis. Requires Dependabot alerts to be enabled when set to enabled. Must be disabled when Dependabot alerts is disabled. not_set leaves existing repository settings unchanged. enum: ["enabled","disabled","not_set"]; default: "disabled"
body.dependabot_security_updates string Optional The enablement status of Dependabot security updates enum: ["enabled","disabled","not_set"]; default: "disabled"
body.dependabot_delegated_alert_dismissal string Optional The enablement status of Dependabot delegated alert dismissal. Requires Dependabot alerts to be enabled. enum: ["enabled","disabled","not_set"]; default: "disabled"
body.code_scanning_options — Optional $ref: "#/definitions/code-scanning-options"
body.code_scanning_default_setup string Optional The enablement status of code scanning default setup enum: ["enabled","disabled","not_set"]; default: "disabled"
body.code_scanning_default_setup_options — Optional $ref: "#/definitions/code-scanning-default-setup-options"
body.code_scanning_delegated_alert_dismissal string Optional The enablement status of code scanning delegated alert dismissal enum: ["enabled","disabled","not_set"]; default: "not_set"
body.secret_protection string Optional The enablement status of GitHub Secret Protection features. enum: ["enabled","disabled","not_set"]
body.secret_scanning string Optional The enablement status of secret scanning enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_scanning_push_protection string Optional The enablement status of secret scanning push protection enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_scanning_delegated_bypass string Optional The enablement status of secret scanning delegated bypass enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_scanning_delegated_bypass_options object Optional Feature options for secret scanning delegated bypass
body.secret_scanning_delegated_bypass_options.reviewers array Optional The bypass reviewers for secret scanning delegated bypass
body.secret_scanning_delegated_bypass_options.reviewers[] object Optional
body.secret_scanning_delegated_bypass_options.reviewers[].reviewer_id integer Required The ID of the team or role selected as a bypass reviewer
body.secret_scanning_delegated_bypass_options.reviewers[].reviewer_type string Required The type of the bypass reviewer enum: ["TEAM","ROLE"]
body.secret_scanning_delegated_bypass_options.reviewers[].mode string Optional The bypass mode for the reviewer enum: ["ALWAYS","EXEMPT"]; default: "ALWAYS"
body.secret_scanning_validity_checks string Optional The enablement status of secret scanning validity checks enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_scanning_non_provider_patterns string Optional The enablement status of secret scanning non provider patterns enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_scanning_generic_secrets string Optional The enablement status of Copilot secret scanning enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_scanning_generic_secrets_push_protection string Optional The enablement status of generic secrets push protection enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_scanning_delegated_alert_dismissal string Optional The enablement status of secret scanning delegated alert dismissal enum: ["enabled","disabled","not_set"]
body.secret_scanning_extended_metadata string Optional The enablement status of secret scanning extended metadata enum: ["enabled","disabled","not_set"]
body.private_vulnerability_reporting string Optional The enablement status of private vulnerability reporting enum: ["enabled","disabled","not_set"]; default: "disabled"
body.enforcement string Optional The enforcement status for a security configuration enum: ["enforced","unenforced"]; default: "enforced"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "octo-org recommended settings",
    "description": "This is a code security configuration for octo-org",
    "advanced_security": "enabled",
    "dependabot_alerts": "enabled",
    "dependabot_security_updates": "not_set",
    "secret_scanning": "enabled"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get default code security configurations — github.code-security.get-default-configurations

Run Get default code security configurations with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Detach configurations from repositories — github.code-security.detach-configuration

Run Detach configurations from repositories with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required additionalProperties: false
body.selected_repository_ids array Required An array of repository IDs to detach from configurations. Up to 250 IDs can be provided. minItems: 1; maxItems: 250
body.selected_repository_ids[] integer Optional Unique identifier of the repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "selected_repository_ids": [
      32,
      91
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a code security configuration — github.code-security.get-configuration

Run Get a code security configuration with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.configuration_id integer Required The unique identifier of the code security configuration.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "configuration_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a code security configuration — github.code-security.update-configuration

Run Update a code security configuration with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.configuration_id integer Required The unique identifier of the code security configuration.
body object Required additionalProperties: false
body.name string Optional The name of the code security configuration. Must be unique within the organization.
body.description string Optional A description of the code security configuration maxLength: 255
body.advanced_security string Optional The enablement status of GitHub Advanced Security features. enabled will enable both Code Security and Secret Protection features. > [!WARNING] > code_security and secret_protection are deprecated values for this field. Prefer the individual code_security and secret_protection fields to set the status of these features. enum: ["enabled","disabled","code_security","secret_protection"]
body.code_security string Optional The enablement status of GitHub Code Security features. enum: ["enabled","disabled","not_set"]
body.dependency_graph string Optional The enablement status of Dependency Graph enum: ["enabled","disabled","not_set"]
body.dependency_graph_autosubmit_action string Optional The enablement status of Automatic dependency submission enum: ["enabled","disabled","not_set"]
body.dependency_graph_autosubmit_action_options object Optional Feature options for Automatic dependency submission
body.dependency_graph_autosubmit_action_options.labeled_runners boolean Optional Whether to use runners labeled with 'dependency-submission' or standard GitHub runners.
body.dependabot_alerts string Optional The enablement status of Dependabot alerts enum: ["enabled","disabled","not_set"]
body.dependabot_reachability string Optional The enablement status of reachability analysis for Dependabot. Only available for organizations with access to reachability analysis. Requires Dependabot alerts to be enabled when set to enabled. Must be disabled when Dependabot alerts is disabled. not_set leaves existing repository settings unchanged. Omit this field to preserve the configuration's current value. enum: ["enabled","disabled","not_set"]
body.dependabot_security_updates string Optional The enablement status of Dependabot security updates enum: ["enabled","disabled","not_set"]
body.dependabot_delegated_alert_dismissal string Optional The enablement status of Dependabot delegated alert dismissal. Requires Dependabot alerts to be enabled. enum: ["enabled","disabled","not_set"]
body.code_scanning_default_setup string Optional The enablement status of code scanning default setup enum: ["enabled","disabled","not_set"]
body.code_scanning_default_setup_options — Optional $ref: "#/definitions/code-scanning-default-setup-options"
body.code_scanning_options — Optional $ref: "#/definitions/code-scanning-options"
body.code_scanning_delegated_alert_dismissal string Optional The enablement status of code scanning delegated alert dismissal enum: ["enabled","disabled","not_set"]; default: "disabled"
body.secret_protection string Optional The enablement status of GitHub Secret Protection features. enum: ["enabled","disabled","not_set"]
body.secret_scanning string Optional The enablement status of secret scanning enum: ["enabled","disabled","not_set"]
body.secret_scanning_push_protection string Optional The enablement status of secret scanning push protection enum: ["enabled","disabled","not_set"]
body.secret_scanning_delegated_bypass string Optional The enablement status of secret scanning delegated bypass enum: ["enabled","disabled","not_set"]
body.secret_scanning_delegated_bypass_options object Optional Feature options for secret scanning delegated bypass
body.secret_scanning_delegated_bypass_options.reviewers array Optional The bypass reviewers for secret scanning delegated bypass
body.secret_scanning_delegated_bypass_options.reviewers[] object Optional
body.secret_scanning_delegated_bypass_options.reviewers[].reviewer_id integer Required The ID of the team or role selected as a bypass reviewer
body.secret_scanning_delegated_bypass_options.reviewers[].reviewer_type string Required The type of the bypass reviewer enum: ["TEAM","ROLE"]
body.secret_scanning_delegated_bypass_options.reviewers[].mode string Optional The bypass mode for the reviewer enum: ["ALWAYS","EXEMPT"]; default: "ALWAYS"
body.secret_scanning_validity_checks string Optional The enablement status of secret scanning validity checks enum: ["enabled","disabled","not_set"]
body.secret_scanning_non_provider_patterns string Optional The enablement status of secret scanning non-provider patterns enum: ["enabled","disabled","not_set"]
body.secret_scanning_generic_secrets string Optional The enablement status of Copilot secret scanning enum: ["enabled","disabled","not_set"]
body.secret_scanning_generic_secrets_push_protection string Optional The enablement status of generic secrets push protection enum: ["enabled","disabled","not_set"]
body.secret_scanning_delegated_alert_dismissal string Optional The enablement status of secret scanning delegated alert dismissal enum: ["enabled","disabled","not_set"]
body.secret_scanning_extended_metadata string Optional The enablement status of secret scanning extended metadata enum: ["enabled","disabled","not_set"]
body.private_vulnerability_reporting string Optional The enablement status of private vulnerability reporting enum: ["enabled","disabled","not_set"]
body.enforcement string Optional The enforcement status for a security configuration enum: ["enforced","unenforced"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "configuration_id": 1
  },
  "body": {
    "name": "octo-org recommended settings v2",
    "secret_scanning": "disabled",
    "code_scanning_default_setup": "enabled"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a code security configuration — github.code-security.delete-configuration

Run Delete a code security configuration with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.configuration_id integer Required The unique identifier of the code security configuration.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "configuration_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Attach a configuration to repositories — github.code-security.attach-configuration

Run Attach a configuration to repositories with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.configuration_id integer Required The unique identifier of the code security configuration.
body object Required additionalProperties: false
body.scope string Required The type of repositories to attach the configuration to. selected means the configuration will be attached to only the repositories specified by selected_repository_ids enum: ["all","all_without_configurations","public","private_or_internal","selected"]
body.selected_repository_ids array Optional An array of repository IDs to attach the configuration to. You can only provide a list of repository ids when the scope is set to selected.
body.selected_repository_ids[] integer Optional Unique identifier of the repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "configuration_id": 1
  },
  "body": {
    "scope": "selected",
    "selected_repository_ids": [
      32,
      91
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set a code security configuration as a default for an organization — github.code-security.set-configuration-as-default

Run Set a code security configuration as a default for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.configuration_id integer Required The unique identifier of the code security configuration.
body object Required
body.default_for_new_repos string Optional Specify which types of repository this security configuration should be applied to by default. enum: ["all","none","private_and_internal","public"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "configuration_id": 1
  },
  "body": {
    "default_for_new_repos": "all"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get repositories associated with a code security configuration — github.code-security.get-repositories-for-configuration

Run Get repositories associated with a code security configuration with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.configuration_id integer Required The unique identifier of the code security configuration.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.status string Optional A comma-separated list of statuses. If specified, only repositories with these attachment statuses will be returned. Can be: all, attached, attaching, detached, removed, enforced, failed, updating, removed_by_enterprise, enterprise_enforced default: "all"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "configuration_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List codespaces for the organization — github.codespaces.list-in-organization

Run List codespaces for the organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization secrets — github.codespaces.list-org-secrets

Run List organization secrets with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization public key — github.codespaces.get-org-public-key

Run Get an organization public key with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization secret — github.codespaces.get-org-secret

Run Get an organization secret with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update an organization secret — github.codespaces.create-or-update-org-secret

Run Create or update an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
body object Required
body.encrypted_value string Optional The value for your secret, encrypted with LibSodium using the public key retrieved from the Get an organization public key endpoint. pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$"
body.key_id string Optional The ID of the key you used to encrypt the secret.
body.visibility string Required Which type of organization repositories have access to the organization secret. selected means only the repositories specified by selected_repository_ids can access the secret. enum: ["all","private","selected"]
body.selected_repository_ids array Optional An array of repository IDs that can access the organization secret. You can only provide a list of repository IDs when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints.
body.selected_repository_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  },
  "body": {
    "encrypted_value": "c2VjcmV0",
    "key_id": "012345678912345678",
    "visibility": "selected",
    "selected_repository_ids": [
      1296269,
      1296280
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an organization secret — github.codespaces.delete-org-secret

Run Delete an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List selected repositories for an organization secret — github.codespaces.list-selected-repos-for-org-secret

Run List selected repositories for an organization secret with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set selected repositories for an organization secret — github.codespaces.set-selected-repos-for-org-secret

Run Set selected repositories for an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
body object Required
body.selected_repository_ids array Required An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can add and remove individual repositories using the Set selected repositories for an organization secret and Remove selected repository from an organization secret endpoints.
body.selected_repository_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  },
  "body": {
    "selected_repository_ids": [
      64780797
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add selected repository to an organization secret — github.codespaces.add-selected-repo-to-org-secret

Run Add selected repository to an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
path.repository_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove selected repository from an organization secret — github.codespaces.remove-selected-repo-from-org-secret

Run Remove selected repository from an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
path.repository_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization Copilot Spaces — github.copilot-spaces.list-for-org

Run List organization Copilot Spaces with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). default: 30; minimum: 1; maximum: 100
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor.
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an organization Copilot Space — github.copilot-spaces.create-for-org

Run Create an organization Copilot Space with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.name string Required The name of the Copilot Space.
body.description string Optional A description of the Copilot Space.
body.general_instructions string Optional General instructions for the Copilot Space. maxLength: 4000
body.base_role string Optional The base role that determines default permissions for organization members. - no_access: No default access (default) - reader: Organization members can read the space - writer: Organization members can read and edit the space - admin: Organization members have full admin access to the space enum: ["reader","writer","admin","no_access"]; default: "no_access"
body.resources_attributes array Optional Resources to attach to the space.
body.resources_attributes[] object Optional
body.resources_attributes[].resource_type string Optional The type of resource. enum: ["repository","github_file","free_text","github_issue","github_pull_request","media_content","uploaded_text_file"]
body.resources_attributes[].metadata object Optional Metadata specific to the resource type.
body.resources_attributes[].metadata.repository_id integer Optional Repository ID for repository or file resources.
body.resources_attributes[].metadata.file_path string Optional File path for file resources.
body.resources_attributes[].metadata.text string Optional Text content for free text resources.
body.resources_attributes[].metadata.name string Optional Name for the resource.
body.resources_attributes[].metadata.number integer Optional Issue or PR number.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "Team Planning Space",
    "description": "Organization space for team planning and coordination",
    "general_instructions": "Help the team with planning and coordination tasks",
    "resources_attributes": [
      {
        "resource_type": "github_file",
        "metadata": {
          "repository_id": 123456,
          "file_path": "docs/planning.md"
        }
      },
      {
        "resource_type": "free_text",
        "metadata": {
          "name": "Team Guidelines",
          "text": "Our team follows agile methodology and holds daily standups"
        }
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization Copilot Space — github.copilot-spaces.get-for-org

Run Get an organization Copilot Space with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.space_number integer Required The unique identifier of the Copilot Space.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "space_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set an organization Copilot Space — github.copilot-spaces.update-for-org

Run Set an organization Copilot Space with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.space_number integer Required The unique identifier of the Copilot Space.
body object Required
body.name string Optional The name of the Copilot Space.
body.description string Optional A description of the Copilot Space.
body.general_instructions string Optional General instructions for the Copilot Space. maxLength: 4000
body.base_role string Optional The base role that determines default permissions for organization members. Changing this field requires admin permissions. - no_access: No default access (default) - reader: Organization members can read the space - writer: Organization members can read and edit the space - admin: Organization members have full admin access to the space enum: ["reader","writer","admin","no_access"]
body.resources_attributes array Optional Resources to attach to the space.
body.resources_attributes[] object Optional
body.resources_attributes[].resource_type string Optional The type of resource. enum: ["repository","github_file","free_text","github_issue","github_pull_request","media_content","uploaded_text_file"]
body.resources_attributes[].metadata object Optional Metadata specific to the resource type.
body.resources_attributes[].metadata.repository_id integer Optional Repository ID for repository or file resources.
body.resources_attributes[].metadata.file_path string Optional File path for file resources.
body.resources_attributes[].metadata.text string Optional Text content for free text resources.
body.resources_attributes[].metadata.name string Optional Name for the resource.
body.resources_attributes[].metadata.number integer Optional Issue or PR number.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "space_number": 1
  },
  "body": {
    "name": "Updated Team Planning Space",
    "description": "Updated organization space for team planning and coordination",
    "general_instructions": "Updated instructions to help the team with planning and coordination tasks",
    "resources_attributes": [
      {
        "resource_type": "github_file",
        "metadata": {
          "repository_id": 123456,
          "file_path": "docs/updated-planning.md"
        }
      },
      {
        "id": 789,
        "_destroy": true
      },
      {
        "id": 456,
        "resource_type": "free_text",
        "metadata": {
          "name": "Updated Team Guidelines",
          "text": "Our updated team follows agile methodology and holds daily standups"
        }
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an organization Copilot Space — github.copilot-spaces.delete-for-org

Run Delete an organization Copilot Space with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.space_number integer Required The unique identifier of the Copilot Space.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "space_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List collaborators for an organization Copilot Space — github.copilot-spaces.list-collaborators-for-org

Run List collaborators for an organization Copilot Space with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.space_number integer Required The unique identifier of the Copilot Space.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "space_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add a collaborator to an organization Copilot Space — github.copilot-spaces.add-collaborator-for-org

Run Add a collaborator to an organization Copilot Space with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.space_number integer Required The unique identifier of the Copilot Space.
body object Required
body.actor_type string Required The type of actor (user or team). enum: ["User","Team"]
body.actor_identifier string Required The username (for users) or team slug (for teams). The numeric ID of a user or team is also accepted.
body.role string Required The role to grant to the collaborator. enum: ["reader","writer","admin"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "space_number": 1
  },
  "body": {
    "actor_type": "User",
    "actor_identifier": "octocat",
    "role": "writer"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set a collaborator role for an organization Copilot Space — github.copilot-spaces.update-collaborator-for-org

Run Set a collaborator role for an organization Copilot Space with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.space_number integer Required The unique identifier of the Copilot Space.
path.actor_type string Required The type of actor (user or team). enum: ["User","Team"]
path.actor_identifier string Required The username (for users) or team slug (for teams). The numeric ID of a user or team is also accepted.
body object Required
body.role string Required The new role to grant to the collaborator. Use no_access to remove the collaborator. enum: ["reader","writer","admin","no_access"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "space_number": 1,
    "actor_type": "User",
    "actor_identifier": "example"
  },
  "body": {
    "role": "admin"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove a collaborator from an organization Copilot Space — github.copilot-spaces.remove-collaborator-for-org

Run Remove a collaborator from an organization Copilot Space with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.space_number integer Required The unique identifier of the Copilot Space.
path.actor_type string Required The type of actor (user or team). enum: ["User","Team"]
path.actor_identifier string Required The username (for users) or team slug (for teams). The numeric ID of a user or team is also accepted.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "space_number": 1,
    "actor_type": "User",
    "actor_identifier": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List resources for an organization Copilot Space — github.copilot-spaces.list-resources-for-org

Run List resources for an organization Copilot Space with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.space_number integer Required The unique identifier of the Copilot Space.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "space_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a resource for an organization Copilot Space — github.copilot-spaces.create-resource-for-org

Run Create a resource for an organization Copilot Space with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.space_number integer Required The unique identifier of the Copilot Space.
body object Required
body.resource_type string Required The type of resource to create. enum: ["repository","github_file","free_text","github_issue","github_pull_request"]
body.metadata object Required Resource-specific metadata. additionalProperties: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "space_number": 1
  },
  "body": {
    "resource_type": "free_text",
    "metadata": {
      "name": "notes.txt",
      "text": "Some helpful notes"
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a resource for an organization Copilot Space — github.copilot-spaces.get-resource-for-org

Run Get a resource for an organization Copilot Space with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.space_number integer Required The unique identifier of the Copilot Space.
path.space_resource_id integer Required The unique identifier of the resource.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "space_number": 1,
    "space_resource_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set a resource for an organization Copilot Space — github.copilot-spaces.update-resource-for-org

Run Set a resource for an organization Copilot Space with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.space_number integer Required The unique identifier of the Copilot Space.
path.space_resource_id integer Required The unique identifier of the resource.
body object Required
body.metadata object Optional Updated resource-specific metadata. additionalProperties: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "space_number": 1,
    "space_resource_id": 1
  },
  "body": {
    "metadata": {
      "name": "updated-notes.txt",
      "text": "Updated content"
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a resource from an organization Copilot Space — github.copilot-spaces.delete-resource-for-org

Run Delete a resource from an organization Copilot Space with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.space_number integer Required The unique identifier of the Copilot Space.
path.space_resource_id integer Required The unique identifier of the resource.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "space_number": 1,
    "space_resource_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Copilot seat information and settings for an organization — github.copilot.get-copilot-organization-details

Run Get Copilot seat information and settings for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List all Copilot seat assignments for an organization — github.copilot.list-copilot-seats

Run List all Copilot seat assignments for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 50

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add teams to the Copilot subscription for an organization — github.copilot.add-copilot-seats-for-teams

Run Add teams to the Copilot subscription for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.selected_teams array Required List of team names within the organization to which to grant access to GitHub Copilot. minItems: 1
body.selected_teams[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "selected_teams": [
      "engteam1",
      "engteam2",
      "engteam3"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove teams from the Copilot subscription for an organization — github.copilot.cancel-copilot-seat-assignment-for-teams

Run Remove teams from the Copilot subscription for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.selected_teams array Required The names of teams from which to revoke access to GitHub Copilot. minItems: 1
body.selected_teams[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "selected_teams": [
      "engteam1",
      "engteam2",
      "engteam3"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add users to the Copilot subscription for an organization — github.copilot.add-copilot-seats-for-users

Run Add users to the Copilot subscription for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.selected_usernames array Required The usernames of the organization members to be granted access to GitHub Copilot. minItems: 1
body.selected_usernames[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "selected_usernames": [
      "cooluser1",
      "hacker2",
      "octocat"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove users from the Copilot subscription for an organization — github.copilot.cancel-copilot-seat-assignment-for-users

Run Remove users from the Copilot subscription for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.selected_usernames array Required The usernames of the organization members for which to revoke access to GitHub Copilot. minItems: 1
body.selected_usernames[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "selected_usernames": [
      "cooluser1",
      "hacker2",
      "octocat"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Copilot cloud agent permissions for an organization — github.copilot.get-copilot-coding-agent-permissions-organization

Run Get Copilot cloud agent permissions for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set Copilot cloud agent permissions for an organization — github.copilot.set-copilot-coding-agent-permissions-organization

Run Set Copilot cloud agent permissions for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.enabled_repositories string Required The policy for which repositories can use Copilot cloud agent. Can be one of all, selected, or none. enum: ["all","selected","none"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "enabled_repositories": "selected"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repositories enabled for Copilot cloud agent in an organization — github.copilot.list-copilot-coding-agent-selected-repositories-for-organization

Run List repositories enabled for Copilot cloud agent in an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set selected repositories for Copilot cloud agent in an organization — github.copilot.set-copilot-coding-agent-selected-repositories-for-organization

Run Set selected repositories for Copilot cloud agent in an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.selected_repository_ids array Required List of repository IDs to enable for Copilot cloud agent.
body.selected_repository_ids[] integer Optional Unique identifier of the repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "selected_repository_ids": [
      32,
      42
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Enable a repository for Copilot cloud agent in an organization — github.copilot.enable-copilot-coding-agent-for-repository-in-organization

Run Enable a repository for Copilot cloud agent in an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.repository_id integer Required The unique identifier of the repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Disable a repository for Copilot cloud agent in an organization — github.copilot.disable-copilot-coding-agent-for-repository-in-organization

Run Disable a repository for Copilot cloud agent in an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.repository_id integer Required The unique identifier of the repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Copilot content exclusion rules for an organization — github.copilot.copilot-content-exclusion-for-organization

Run Get Copilot content exclusion rules for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set Copilot content exclusion rules for an organization — github.copilot.set-copilot-content-exclusion-for-organization

Run Set Copilot content exclusion rules for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required additionalProperties: {"type":"array","items":{"anyOf":[{"type":"string","description":"The path to the file that will be excluded."},{"type":"object","properties":{"ifAnyMatch":{"type":"array","items":{"type":"string"}}},"required":["ifAnyMatch"],"additionalProperties":false},{"type":"object","properties":{"ifNoneMatch":{"type":"array","items":{"type":"string"}}},"required":["ifNoneMatch"],"additionalProperties":false}]}}

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "octo-repo": [
      "/src/some-dir/kernel.rs"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Copilot organization usage metrics for a specific day — github.copilot.copilot-organization-one-day-usage-metrics

Run Get Copilot organization usage metrics for a specific day with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Required additionalProperties: false
query.day string Required The day to request data for, in YYYY-MM-DD format. format: "date"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "query": {
    "day": "2025-10-13"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Copilot organization usage metrics — github.copilot.copilot-organization-usage-metrics

Run Get Copilot organization usage metrics with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Copilot organization repository report for a specific day — github.copilot.copilot-organization-repos-one-day-report

Run Get Copilot organization repository report for a specific day with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Required additionalProperties: false
query.day string Required The day to request data for, in YYYY-MM-DD format. format: "date"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "query": {
    "day": "2025-10-13"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Copilot organization user-teams report for a specific day — github.copilot.copilot-organization-user-teams-one-day-report

Run Get Copilot organization user-teams report for a specific day with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Required additionalProperties: false
query.day string Required The day to request data for, in YYYY-MM-DD format. format: "date"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "query": {
    "day": "2025-10-13"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Copilot organization users usage metrics for a specific day — github.copilot.copilot-organization-users-one-day-usage-metrics

Run Get Copilot organization users usage metrics for a specific day with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Required additionalProperties: false
query.day string Required The day to request data for, in YYYY-MM-DD format. format: "date"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "query": {
    "day": "2025-10-13"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Copilot organization users usage metrics — github.copilot.copilot-organization-users-usage-metrics

Run Get Copilot organization users usage metrics with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List Dependabot alerts for an organization — github.dependabot.list-alerts-for-org

Run List Dependabot alerts for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.classification string Optional A comma-separated list of vulnerability classifications. If specified, only alerts for vulnerabilities with these classifications will be returned. Can be: malware, general
query.state string Optional A comma-separated list of states. If specified, only alerts with these states will be returned. Can be: auto_dismissed, dismissed, fixed, open
query.severity string Optional A comma-separated list of severities. If specified, only alerts with these severities will be returned. Can be: low, medium, high, critical
query.ecosystem string Optional A comma-separated list of ecosystems. If specified, only alerts for these ecosystems will be returned. Can be: composer, go, maven, npm, nuget, pip, pub, rubygems, rust
query.package string Optional A comma-separated list of package names. If specified, only alerts for these packages will be returned.
query.epss_percentage string Optional CVE Exploit Prediction Scoring System (EPSS) percentage. Can be specified as: - An exact number (n) - Comparators such as >n, <n, >=n, <=n - A range like n..n, where n is a number from 0.0 to 1.0 Filters the list of alerts based on EPSS percentages. If specified, only alerts with the provided EPSS percentages will be returned.
query.artifact_registry_url string Optional A comma-separated list of artifact registry URLs. If specified, only alerts for repositories with storage records matching these URLs will be returned.
query.artifact_registry string Optional A comma-separated list of Artifact Registry name strings. If specified, only alerts for repositories with storage records matching these registries will be returned. Can be: jfrog-artifactory
query.has — Optional Filters the list of alerts based on whether the alert has the given value. If specified, only alerts meeting this criterion will be returned. Multiple has filters can be passed to filter for alerts that have all of the values.
query.has string Optional oneOf[1]
query.has array Optional oneOf[2]
query.has[] string Optional oneOf[2]; enum: ["patch","deployment"]
query.assignee string Optional Filter alerts by assignees. Provide a comma-separated list of user handles (e.g., octocat or octocat,hubot) to return alerts assigned to any of the specified users. Use * to list alerts with at least one assignee or none to list alerts with no assignees.
query.runtime_risk string Optional A comma-separated list of runtime risk strings. If specified, only alerts for repositories with deployment records matching these risks will be returned. Can be: critical-resource, internet-exposed, sensitive-data, lateral-movement
query.scope string Optional The scope of the vulnerable dependency. If specified, only alerts with this scope will be returned. enum: ["development","runtime"]
query.relationship string Optional A comma-separated list of relationships of the vulnerable dependency to your project. If specified, only alerts with these relationships will be returned. > [!NOTE] > We are rolling out support for dependency relationship across ecosystems. This value will be "unknown" for all dependencies in unsupported ecosystems.
query.sort string Optional The property by which to sort the results. created means when the alert was created. updated means when the alert's state last changed. epss_percentage sorts alerts by the Exploit Prediction Scoring System (EPSS) percentage. enum: ["created","updated","epss_percentage"]; default: "created"
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Lists the repositories Dependabot can access in an organization — github.dependabot.repository-access-for-org

Run Lists the repositories Dependabot can access in an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.page integer Optional The page number of results to fetch. default: 1; minimum: 1
query.per_page integer Optional Number of results per page. default: 30; minimum: 1; maximum: 100

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Updates Dependabot's repository access list for an organization — github.dependabot.update-repository-access-for-org

Run Updates Dependabot's repository access list for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.repository_ids_to_add array Optional List of repository IDs to add.
body.repository_ids_to_add[] integer Optional
body.repository_ids_to_remove array Optional List of repository IDs to remove.
body.repository_ids_to_remove[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "repository_ids_to_add": [
      123,
      456
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set the default repository access level for Dependabot — github.dependabot.set-repository-access-default-level

Run Set the default repository access level for Dependabot with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.default_level string Required The default repository access level for Dependabot updates. enum: ["public","internal"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "default_level": "public"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization secrets — github.dependabot.list-org-secrets

Run List organization secrets with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization public key — github.dependabot.get-org-public-key

Run Get an organization public key with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization secret — github.dependabot.get-org-secret

Run Get an organization secret with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update an organization secret — github.dependabot.create-or-update-org-secret

Run Create or update an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
body object Required
body.encrypted_value string Optional Value for your secret, encrypted with LibSodium using the public key retrieved from the Get an organization public key endpoint. pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$"
body.key_id string Optional ID of the key you used to encrypt the secret.
body.visibility string Required Which type of organization repositories have access to the organization secret. selected means only the repositories specified by selected_repository_ids can access the secret. enum: ["all","private","selected"]
body.selected_repository_ids array Optional An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can manage the list of selected repositories using the List selected repositories for an organization secret, Set selected repositories for an organization secret, and Remove selected repository from an organization secret endpoints.
body.selected_repository_ids[] — Optional
body.selected_repository_ids[] integer Optional anyOf[1]
body.selected_repository_ids[] string Optional anyOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  },
  "body": {
    "encrypted_value": "c2VjcmV0",
    "key_id": "012345678912345678",
    "visibility": "selected",
    "selected_repository_ids": [
      1296269,
      1296280
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an organization secret — github.dependabot.delete-org-secret

Run Delete an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List selected repositories for an organization secret — github.dependabot.list-selected-repos-for-org-secret

Run List selected repositories for an organization secret with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set selected repositories for an organization secret — github.dependabot.set-selected-repos-for-org-secret

Run Set selected repositories for an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
body object Required
body.selected_repository_ids array Required An array of repository ids that can access the organization secret. You can only provide a list of repository ids when the visibility is set to selected. You can add and remove individual repositories using the Set selected repositories for an organization secret and Remove selected repository from an organization secret endpoints.
body.selected_repository_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  },
  "body": {
    "selected_repository_ids": [
      64780797
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add selected repository to an organization secret — github.dependabot.add-selected-repo-to-org-secret

Run Add selected repository to an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
path.repository_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove selected repository from an organization secret — github.dependabot.remove-selected-repo-from-org-secret

Run Remove selected repository from an organization secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
path.repository_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get list of conflicting packages during Docker migration for organization — github.packages.list-docker-migration-conflicting-packages-for-organization

Run Get list of conflicting packages during Docker migration for organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List public organization events — github.activity.list-public-org-events

Run List public organization events with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List failed organization invitations — github.orgs.list-failed-invitations

Run List failed organization invitations with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization webhooks — github.orgs.list-webhooks

Run List organization webhooks with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an organization webhook — github.orgs.create-webhook

Run Create an organization webhook with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.name string Required Must be passed as "web".
body.config object Required Key/value pairs to provide settings for this webhook.
body.config.url — Required $ref: "#/definitions/webhook-config-url"
body.config.content_type — Optional $ref: "#/definitions/webhook-config-content-type"
body.config.secret — Optional $ref: "#/definitions/webhook-config-secret"
body.config.insecure_ssl — Optional $ref: "#/definitions/webhook-config-insecure-ssl"
body.config.username string Optional
body.config.password string Optional
body.events array Optional Determines what events the hook is triggered for. Set to ["*"] to receive all possible events. default: ["push"]
body.events[] string Optional
body.active boolean Optional Determines if notifications are sent when the webhook is triggered. Set to true to send notifications. default: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "web",
    "active": true,
    "events": [
      "push",
      "pull_request"
    ],
    "config": {
      "url": "http://example.com/webhook",
      "content_type": "json"
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization webhook — github.orgs.get-webhook

Run Get an organization webhook with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "hook_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update an organization webhook — github.orgs.update-webhook

Run Update an organization webhook with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.
body object Optional
body.config object Optional Key/value pairs to provide settings for this webhook.
body.config.url — Required $ref: "#/definitions/webhook-config-url"
body.config.content_type — Optional $ref: "#/definitions/webhook-config-content-type"
body.config.secret — Optional $ref: "#/definitions/webhook-config-secret"
body.config.insecure_ssl — Optional $ref: "#/definitions/webhook-config-insecure-ssl"
body.events array Optional Determines what events the hook is triggered for. default: ["push"]
body.events[] string Optional
body.active boolean Optional Determines if notifications are sent when the webhook is triggered. Set to true to send notifications. default: true
body.name string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "hook_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an organization webhook — github.orgs.delete-webhook

Run Delete an organization webhook with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "hook_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a webhook configuration for an organization — github.orgs.get-webhook-config-for-org

Run Get a webhook configuration for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "hook_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a webhook configuration for an organization — github.orgs.update-webhook-config-for-org

Run Update a webhook configuration for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.
body object Optional
body.url — Optional $ref: "#/definitions/webhook-config-url"
body.content_type — Optional $ref: "#/definitions/webhook-config-content-type"
body.secret — Optional $ref: "#/definitions/webhook-config-secret"
body.insecure_ssl — Optional $ref: "#/definitions/webhook-config-insecure-ssl"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "hook_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List deliveries for an organization webhook — github.orgs.list-webhook-deliveries

Run List deliveries for an organization webhook with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.cursor string Optional Used for pagination: the starting delivery from which the page of deliveries is fetched. Refer to the link header for the next and previous page cursors.
query.status string Optional Returns webhook deliveries filtered by delivery outcome classification based on status_code range. A status of success returns deliveries with a status_code in the 200-399 range (inclusive). A status of failure returns deliveries with a status_code in the 400-599 range (inclusive). enum: ["success","failure"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "hook_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a webhook delivery for an organization webhook — github.orgs.get-webhook-delivery

Run Get a webhook delivery for an organization webhook with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.
path.delivery_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "hook_id": 1,
    "delivery_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Redeliver a delivery for an organization webhook — github.orgs.redeliver-webhook-delivery

Run Redeliver a delivery for an organization webhook with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.
path.delivery_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "hook_id": 1,
    "delivery_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Ping an organization webhook — github.orgs.ping-webhook

Run Ping an organization webhook with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "hook_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get route stats by actor — github.api-insights.get-route-stats-by-actor

Run Get route stats by actor with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.actor_type string Required The type of the actor enum: ["installation","classic_pat","fine_grained_pat","oauth_app","github_app_user_to_server"]
path.actor_id integer Required The ID of the actor
query object Required additionalProperties: false
query.min_timestamp string Required The minimum timestamp to query for stats. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
query.max_timestamp string Optional The maximum timestamp to query for stats. Defaults to the time 30 days ago. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.sort array Optional The property to sort the results by.
query.sort[] string Optional enum: ["last_rate_limited_timestamp","last_request_timestamp","rate_limited_request_count","http_method","api_route","total_request_count"]; default: "total_request_count"
query.api_route_substring string Optional Providing a substring will filter results where the API route contains the substring. This is a case-insensitive search.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "actor_type": "installation",
    "actor_id": 1
  },
  "query": {
    "min_timestamp": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get subject stats — github.api-insights.get-subject-stats

Run Get subject stats with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Required additionalProperties: false
query.min_timestamp string Required The minimum timestamp to query for stats. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
query.max_timestamp string Optional The maximum timestamp to query for stats. Defaults to the time 30 days ago. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.sort array Optional The property to sort the results by.
query.sort[] string Optional enum: ["last_rate_limited_timestamp","last_request_timestamp","rate_limited_request_count","subject_name","total_request_count"]; default: "total_request_count"
query.subject_name_substring string Optional Providing a substring will filter results where the subject name contains the substring. This is a case-insensitive search.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "query": {
    "min_timestamp": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get summary stats — github.api-insights.get-summary-stats

Run Get summary stats with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Required additionalProperties: false
query.min_timestamp string Required The minimum timestamp to query for stats. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
query.max_timestamp string Optional The maximum timestamp to query for stats. Defaults to the time 30 days ago. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "query": {
    "min_timestamp": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get summary stats by user — github.api-insights.get-summary-stats-by-user

Run Get summary stats by user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.user_id string Required The ID of the user to query for stats
query object Required additionalProperties: false
query.min_timestamp string Required The minimum timestamp to query for stats. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
query.max_timestamp string Optional The maximum timestamp to query for stats. Defaults to the time 30 days ago. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "user_id": "example"
  },
  "query": {
    "min_timestamp": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get summary stats by actor — github.api-insights.get-summary-stats-by-actor

Run Get summary stats by actor with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.actor_type string Required The type of the actor enum: ["installation","classic_pat","fine_grained_pat","oauth_app","github_app_user_to_server"]
path.actor_id integer Required The ID of the actor
query object Required additionalProperties: false
query.min_timestamp string Required The minimum timestamp to query for stats. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
query.max_timestamp string Optional The maximum timestamp to query for stats. Defaults to the time 30 days ago. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "actor_type": "installation",
    "actor_id": 1
  },
  "query": {
    "min_timestamp": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get time stats — github.api-insights.get-time-stats

Run Get time stats with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Required additionalProperties: false
query.min_timestamp string Required The minimum timestamp to query for stats. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
query.max_timestamp string Optional The maximum timestamp to query for stats. Defaults to the time 30 days ago. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
query.timestamp_increment string Required The increment of time used to breakdown the query results (5m, 10m, 1h, etc.)

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "query": {
    "min_timestamp": "example",
    "timestamp_increment": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get time stats by user — github.api-insights.get-time-stats-by-user

Run Get time stats by user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.user_id string Required The ID of the user to query for stats
query object Required additionalProperties: false
query.min_timestamp string Required The minimum timestamp to query for stats. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
query.max_timestamp string Optional The maximum timestamp to query for stats. Defaults to the time 30 days ago. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
query.timestamp_increment string Required The increment of time used to breakdown the query results (5m, 10m, 1h, etc.)

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "user_id": "example"
  },
  "query": {
    "min_timestamp": "example",
    "timestamp_increment": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get time stats by actor — github.api-insights.get-time-stats-by-actor

Run Get time stats by actor with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.actor_type string Required The type of the actor enum: ["installation","classic_pat","fine_grained_pat","oauth_app","github_app_user_to_server"]
path.actor_id integer Required The ID of the actor
query object Required additionalProperties: false
query.min_timestamp string Required The minimum timestamp to query for stats. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
query.max_timestamp string Optional The maximum timestamp to query for stats. Defaults to the time 30 days ago. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
query.timestamp_increment string Required The increment of time used to breakdown the query results (5m, 10m, 1h, etc.)

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "actor_type": "installation",
    "actor_id": 1
  },
  "query": {
    "min_timestamp": "example",
    "timestamp_increment": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get user stats — github.api-insights.get-user-stats

Run Get user stats with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.user_id string Required The ID of the user to query for stats
query object Required additionalProperties: false
query.min_timestamp string Required The minimum timestamp to query for stats. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
query.max_timestamp string Optional The maximum timestamp to query for stats. Defaults to the time 30 days ago. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.sort array Optional The property to sort the results by.
query.sort[] string Optional enum: ["last_rate_limited_timestamp","last_request_timestamp","rate_limited_request_count","subject_name","total_request_count"]; default: "total_request_count"
query.actor_name_substring string Optional Providing a substring will filter results where the actor name contains the substring. This is a case-insensitive search.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "user_id": "example"
  },
  "query": {
    "min_timestamp": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization installation for the authenticated app — github.apps.get-org-installation

Run Get an organization installation for the authenticated app with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List app installations for an organization — github.orgs.list-app-installations

Run List app installations for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get interaction restrictions for an organization — github.interactions.get-restrictions-for-org

Run Get interaction restrictions for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set interaction restrictions for an organization — github.interactions.set-restrictions-for-org

Run Set interaction restrictions for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body — Required $ref: "#/definitions/interaction-limit"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "limit": "collaborators_only"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove interaction restrictions for an organization — github.interactions.remove-restrictions-for-org

Run Remove interaction restrictions for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get pull request creation cap for an org — github.interactions.get-pull-request-creation-cap-for-org

Run Get pull request creation cap for an org with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update pull request creation cap for an org — github.interactions.update-pull-request-creation-cap-for-org

Run Update pull request creation cap for an org with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.enabled boolean Required Whether the pull request creation cap is enabled
body.max_open_pull_requests integer Optional The maximum number of open pull requests a user can have at one time minimum: 1; maximum: 1000
body.include_drafts boolean Optional Whether draft pull requests count toward the pull request creation cap

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "enabled": true,
    "max_open_pull_requests": 1,
    "include_drafts": true
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List pending organization invitations — github.orgs.list-pending-invitations

Run List pending organization invitations with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.role string Optional Filter invitations by their member role. enum: ["all","admin","direct_member","billing_manager","hiring_manager"]; default: "all"
query.invitation_source string Optional Filter invitations by their invitation source. enum: ["all","member","scim"]; default: "all"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an organization invitation — github.orgs.create-invitation

Run Create an organization invitation with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Optional
body.invitee_id integer Optional Required unless you provide email. GitHub user ID for the person you are inviting.
body.email string Optional Required unless you provide invitee_id. Email address of the person you are inviting, which can be an existing GitHub user.
body.role string Optional The role for the new member. * admin - Organization owners with full administrative rights to the organization and complete access to all repositories and teams. * direct_member - Non-owner organization members with ability to see other members and join teams by invitation. * billing_manager - Non-owner organization members with ability to manage the billing settings of your organization. * reinstate - The previous role assigned to the invitee before they were removed from your organization. Can be one of the roles listed above. Only works if the invitee was previously part of your organization. enum: ["admin","direct_member","billing_manager","reinstate"]; default: "direct_member"
body.team_ids array Optional Specify IDs for the teams you want to invite new members to.
body.team_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Cancel an organization invitation — github.orgs.cancel-invitation

Run Cancel an organization invitation with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.invitation_id integer Required The unique identifier of the invitation.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "invitation_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization invitation teams — github.orgs.list-invitation-teams

Run List organization invitation teams with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.invitation_id integer Required The unique identifier of the invitation.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "invitation_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List issue fields for an organization — github.orgs.list-issue-fields

Run List issue fields for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create issue field for an organization — github.orgs.create-issue-field

Run Create issue field for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body — Required $ref: "#/definitions/organization-create-issue-field"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "example",
    "data_type": "text"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update issue field for an organization — github.orgs.update-issue-field

Run Update issue field for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.issue_field_id integer Required The unique identifier of the issue field.
body — Required $ref: "#/definitions/organization-update-issue-field"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "issue_field_id": 1
  },
  "body": {}
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete issue field for an organization — github.orgs.delete-issue-field

Run Delete issue field for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.issue_field_id integer Required The unique identifier of the issue field.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "issue_field_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List issue types for an organization — github.orgs.list-issue-types

Run List issue types for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create issue type for an organization — github.orgs.create-issue-type

Run Create issue type for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body — Required $ref: "#/definitions/organization-create-issue-type"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "example",
    "is_enabled": false
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update issue type for an organization — github.orgs.update-issue-type

Run Update issue type for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.issue_type_id integer Required The unique identifier of the issue type.
body — Required $ref: "#/definitions/organization-update-issue-type"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "issue_type_id": 1
  },
  "body": {
    "name": "example",
    "is_enabled": false
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete issue type for an organization — github.orgs.delete-issue-type

Run Delete issue type for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.issue_type_id integer Required The unique identifier of the issue type.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "issue_type_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization issues assigned to the authenticated user — github.issues.list-for-org

Run List organization issues assigned to the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.filter string Optional Indicates which sorts of issues to return. assigned means issues assigned to you. created means issues created by you. mentioned means issues mentioning you. subscribed means issues you're subscribed to updates for. all or repos means all issues you can see, regardless of participation or creation. enum: ["assigned","created","mentioned","subscribed","repos","all"]; default: "assigned"
query.state string Optional Indicates the state of the issues to return. enum: ["open","closed","all"]; default: "open"
query.labels string Optional A list of comma separated label names. Example: bug,ui,@high
query.type string Optional Can be the name of an issue type.
query.sort string Optional What to sort results by. enum: ["created","updated","comments"]; default: "created"
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.since string Optional Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization members — github.orgs.list-members

Run List organization members with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.filter string Optional Filter members returned in the list. 2fa_disabled means that only members without two-factor authentication enabled will be returned. 2fa_insecure means that only members with insecure 2FA methods will be returned. These options are only available for organization owners. enum: ["2fa_disabled","2fa_insecure","all"]; default: "all"
query.role string Optional Filter members returned by their role. enum: ["all","admin","member"]; default: "all"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check organization membership for a user — github.orgs.check-membership-for-user

Run Check organization membership for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove an organization member — github.orgs.remove-member

Run Remove an organization member with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List codespaces for a user in organization — github.codespaces.get-codespaces-for-user-in-org

Run List codespaces for a user in organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a codespace from the organization — github.codespaces.delete-from-organization

Run Delete a codespace from the organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.
path.codespace_name string Required The name of the codespace.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example",
    "codespace_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Stop a codespace for an organization user — github.codespaces.stop-in-organization

Run Stop a codespace for an organization user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.
path.codespace_name string Required The name of the codespace.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example",
    "codespace_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Copilot seat assignment details for a user — github.copilot.get-copilot-seat-details-for-user

Run Get Copilot seat assignment details for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get organization membership for a user — github.orgs.get-membership-for-user

Run Get organization membership for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set organization membership for a user — github.orgs.set-membership-for-user

Run Set organization membership for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.
body object Optional
body.role string Optional The role to give the user in the organization. Can be one of: * admin - The user will become an owner of the organization. * member - The user will become a non-owner member of the organization. enum: ["admin","member"]; default: "member"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove organization membership for a user — github.orgs.remove-membership-for-user

Run Remove organization membership for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization migrations — github.migrations.list-for-org

Run List organization migrations with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.exclude array Optional Exclude attributes from the API response to improve performance
query.exclude[] string Optional Allowed values that can be passed to the exclude param. enum: ["repositories"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Start an organization migration — github.migrations.start-for-org

Run Start an organization migration with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.repositories array Required A list of arrays indicating which repositories should be migrated.
body.repositories[] string Optional
body.lock_repositories boolean Optional Indicates whether repositories should be locked (to prevent manipulation) while migrating data. default: false
body.exclude_metadata boolean Optional Indicates whether metadata should be excluded and only git source should be included for the migration. default: false
body.exclude_git_data boolean Optional Indicates whether the repository git data should be excluded from the migration. default: false
body.exclude_attachments boolean Optional Indicates whether attachments should be excluded from the migration (to reduce migration archive file size). default: false
body.exclude_releases boolean Optional Indicates whether releases should be excluded from the migration (to reduce migration archive file size). default: false
body.exclude_owner_projects boolean Optional Indicates whether projects owned by the organization or users should be excluded. from the migration. default: false
body.org_metadata_only boolean Optional Indicates whether this should only include organization metadata (repositories array should be empty and will ignore other flags). default: false
body.exclude array Optional Exclude related items from being returned in the response in order to improve performance of the request.
body.exclude[] string Optional enum: ["repositories"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "repositories": [
      "github/Hello-World"
    ],
    "lock_repositories": true
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization migration status — github.migrations.get-status-for-org

Run Get an organization migration status with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.migration_id integer Required The unique identifier of the migration.
query object Optional additionalProperties: false
query.exclude array Optional Exclude attributes from the API response to improve performance
query.exclude[] string Optional Allowed values that can be passed to the exclude param. enum: ["repositories"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "migration_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an organization migration archive — github.migrations.delete-archive-for-org

Run Delete an organization migration archive with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.migration_id integer Required The unique identifier of the migration.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "migration_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Unlock an organization repository — github.migrations.unlock-repo-for-org

Run Unlock an organization repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.migration_id integer Required The unique identifier of the migration.
path.repo_name string Required repo_name parameter

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "migration_id": 1,
    "repo_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repositories in an organization migration — github.migrations.list-repos-for-org

Run List repositories in an organization migration with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.migration_id integer Required The unique identifier of the migration.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "migration_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get all organization roles for an organization — github.orgs.list-org-roles

Run Get all organization roles for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove all organization roles for a team — github.orgs.revoke-all-org-roles-team

Run Remove all organization roles for a team with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.team_slug string Required The slug of the team name.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "team_slug": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Assign an organization role to a team — github.orgs.assign-team-to-org-role

Run Assign an organization role to a team with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.team_slug string Required The slug of the team name.
path.role_id integer Required The unique identifier of the role.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "team_slug": "example",
    "role_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove an organization role from a team — github.orgs.revoke-org-role-team

Run Remove an organization role from a team with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.team_slug string Required The slug of the team name.
path.role_id integer Required The unique identifier of the role.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "team_slug": "example",
    "role_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove all organization roles for a user — github.orgs.revoke-all-org-roles-user

Run Remove all organization roles for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Assign an organization role to a user — github.orgs.assign-user-to-org-role

Run Assign an organization role to a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.
path.role_id integer Required The unique identifier of the role.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example",
    "role_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove an organization role from a user — github.orgs.revoke-org-role-user

Run Remove an organization role from a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.
path.role_id integer Required The unique identifier of the role.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example",
    "role_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization role — github.orgs.get-org-role

Run Get an organization role with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.role_id integer Required The unique identifier of the role.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "role_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List teams that are assigned to an organization role — github.orgs.list-org-role-teams

Run List teams that are assigned to an organization role with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.role_id integer Required The unique identifier of the role.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "role_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List users that are assigned to an organization role — github.orgs.list-org-role-users

Run List users that are assigned to an organization role with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.role_id integer Required The unique identifier of the role.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "role_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List outside collaborators for an organization — github.orgs.list-outside-collaborators

Run List outside collaborators for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.filter string Optional Filter the list of outside collaborators. 2fa_disabled means that only outside collaborators without two-factor authentication enabled will be returned. 2fa_insecure means that only outside collaborators with insecure 2FA methods will be returned. enum: ["2fa_disabled","2fa_insecure","all"]; default: "all"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Convert an organization member to outside collaborator — github.orgs.convert-member-to-outside-collaborator

Run Convert an organization member to outside collaborator with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.
body object Optional
body.async boolean Optional When set to true, the request will be performed asynchronously. Returns a 202 status code when the job is successfully queued. default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove outside collaborator from an organization — github.orgs.remove-outside-collaborator

Run Remove outside collaborator from an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List packages for an organization — github.packages.list-packages-for-organization

Run List packages for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Required additionalProperties: false
query.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
query.visibility string Optional The selected visibility of the packages. This parameter is optional and only filters an existing result set. The internal visibility is only supported for GitHub Packages registries that allow for granular permissions. For other ecosystems internal is synonymous with private. For the list of GitHub Packages registries that support granular permissions, see "About permissions for GitHub Packages." enum: ["public","private","internal"]
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "package_type": "npm"
  },
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a package for an organization — github.packages.get-package-for-organization

Run Get a package for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example",
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a package for an organization — github.packages.delete-package-for-org

Run Delete a package for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example",
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Restore a package for an organization — github.packages.restore-package-for-org

Run Restore a package for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.token string Optional package token

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example",
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List package versions for a package owned by an organization — github.packages.get-all-package-versions-for-package-owned-by-org

Run List package versions for a package owned by an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.state string Optional The state of the package, either active or deleted. enum: ["active","deleted"]; default: "active"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example",
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a package version for an organization — github.packages.get-package-version-for-organization

Run Get a package version for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
path.org string Required The organization name. The name is not case sensitive.
path.package_version_id integer Required Unique identifier of the package version.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example",
    "org": "example",
    "package_version_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete package version for an organization — github.packages.delete-package-version-for-org

Run Delete package version for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
path.org string Required The organization name. The name is not case sensitive.
path.package_version_id integer Required Unique identifier of the package version.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example",
    "org": "example",
    "package_version_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Restore package version for an organization — github.packages.restore-package-version-for-org

Run Restore package version for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
path.org string Required The organization name. The name is not case sensitive.
path.package_version_id integer Required Unique identifier of the package version.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example",
    "org": "example",
    "package_version_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List requests to access organization resources with fine-grained personal access tokens — github.orgs.list-pat-grant-requests

Run List requests to access organization resources with fine-grained personal access tokens with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.sort string Optional The property by which to sort the results. enum: ["created_at"]; default: "created_at"
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.owner array Optional A list of owner usernames to use to filter the results. maxItems: 10
query.owner[] string Optional
query.repository string Optional The name of the repository to use to filter the results.
query.permission string Optional The permission to use to filter the results.
query.last_used_before string Optional Only show fine-grained personal access tokens used before the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.last_used_after string Optional Only show fine-grained personal access tokens used after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.token_id array Optional The ID of the token maxItems: 50
query.token_id[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Review requests to access organization resources with fine-grained personal access tokens — github.orgs.review-pat-grant-requests-in-bulk

Run Review requests to access organization resources with fine-grained personal access tokens with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.pat_request_ids array Optional Unique identifiers of the requests for access via fine-grained personal access token. Must be formed of between 1 and 100 pat_request_id values. minItems: 1; maxItems: 100
body.pat_request_ids[] integer Optional
body.action string Required Action to apply to the requests. enum: ["approve","deny"]
body.reason string | null Optional Reason for approving or denying the requests. Max 1024 characters. maxLength: 1024

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "pat_request_ids": [
      42,
      73
    ],
    "action": "deny",
    "reason": "Access is too broad."
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Review a request to access organization resources with a fine-grained personal access token — github.orgs.review-pat-grant-request

Run Review a request to access organization resources with a fine-grained personal access token with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.pat_request_id integer Required Unique identifier of the request for access via fine-grained personal access token.
body object Required
body.action string Required Action to apply to the request. enum: ["approve","deny"]
body.reason string | null Optional Reason for approving or denying the request. Max 1024 characters. maxLength: 1024

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "pat_request_id": 1
  },
  "body": {
    "action": "deny",
    "reason": "This request is denied because the access is too broad."
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repositories requested to be accessed by a fine-grained personal access token — github.orgs.list-pat-grant-request-repositories

Run List repositories requested to be accessed by a fine-grained personal access token with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.pat_request_id integer Required Unique identifier of the request for access via fine-grained personal access token.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "pat_request_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List fine-grained personal access tokens with access to organization resources — github.orgs.list-pat-grants

Run List fine-grained personal access tokens with access to organization resources with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.sort string Optional The property by which to sort the results. enum: ["created_at"]; default: "created_at"
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.owner array Optional A list of owner usernames to use to filter the results. maxItems: 10
query.owner[] string Optional
query.repository string Optional The name of the repository to use to filter the results.
query.permission string Optional The permission to use to filter the results.
query.last_used_before string Optional Only show fine-grained personal access tokens used before the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.last_used_after string Optional Only show fine-grained personal access tokens used after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.token_id array Optional The ID of the token maxItems: 50
query.token_id[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update the access to organization resources via fine-grained personal access tokens — github.orgs.update-pat-accesses

Run Update the access to organization resources via fine-grained personal access tokens with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.action string Required Action to apply to the fine-grained personal access token. enum: ["revoke"]
body.pat_ids array Required The IDs of the fine-grained personal access tokens. minItems: 1; maxItems: 100
body.pat_ids[] integer Optional Unique identifier of the fine-grained personal access token.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "action": "revoke",
    "pat_ids": [
      1296269,
      1296280
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update the access a fine-grained personal access token has to organization resources — github.orgs.update-pat-access

Run Update the access a fine-grained personal access token has to organization resources with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.pat_id integer Required The unique identifier of the fine-grained personal access token.
body object Required
body.action string Required Action to apply to the fine-grained personal access token. enum: ["revoke"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "pat_id": 1
  },
  "body": {
    "action": "revoke"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repositories a fine-grained personal access token has access to — github.orgs.list-pat-grant-repositories

Run List repositories a fine-grained personal access token has access to with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.pat_id integer Required Unique identifier of the fine-grained personal access token.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "pat_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List private registries for an organization — github.private-registries.list-org-private-registries

Run List private registries for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a private registry for an organization — github.private-registries.create-org-private-registry

Run Create a private registry for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.registry_type string Required The registry type. enum: ["maven_repository","nuget_feed","goproxy_server","npm_registry","rubygems_server","cargo_registry","composer_repository","docker_registry","git_source","helm_registry","hex_organization","hex_repository","pub_repository","python_index","terraform_registry"]
body.url string Required The URL of the private registry. format: "uri"
body.username string | null Optional The username to use when authenticating with the private registry. This field should be omitted if the private registry does not require a username for authentication.
body.replaces_base boolean Optional Whether this private registry should replace the base registry (e.g., npmjs.org for npm, rubygems.org for rubygems). When set to true, Dependabot will only use this registry and will not fall back to the public registry. When set to false (default), Dependabot will use this registry for scoped packages but may fall back to the public registry for other packages. default: false
body.encrypted_value string Optional The value for your secret, encrypted with LibSodium using the public key retrieved from the Get private registries public key for an organization endpoint. Required when auth_type is token or username_password. Should be omitted for OIDC auth types. pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$"
body.key_id string Optional The ID of the key you used to encrypt the secret. Required when auth_type is token or username_password. Should be omitted for OIDC auth types.
body.visibility string Required Which type of organization repositories have access to the private registry. selected means only the repositories specified by selected_repository_ids can access the private registry. enum: ["all","private","selected"]
body.selected_repository_ids array Optional An array of repository IDs that can access the organization private registry. You can only provide a list of repository IDs when visibility is set to selected. You can manage the list of selected repositories using the Update a private registry for an organization endpoint. This field should be omitted if visibility is set to all or private.
body.selected_repository_ids[] integer Optional
body.auth_type string Optional The authentication type for the private registry. Defaults to token if not specified. Use oidc_azure, oidc_aws, oidc_jfrog, oidc_cloudsmith, or oidc_gcp for OIDC authentication. Use anonymous for registries that do not require authentication; username, encrypted_value, and key_id must be omitted. enum: ["token","username_password","oidc_azure","oidc_aws","oidc_jfrog","oidc_cloudsmith","oidc_gcp","anonymous"]
body.tenant_id string Optional The tenant ID of the Azure AD application. Required when auth_type is oidc_azure.
body.client_id string Optional The client ID of the Azure AD application. Required when auth_type is oidc_azure.
body.aws_region string Optional The AWS region. Required when auth_type is oidc_aws.
body.account_id string Optional The AWS account ID. Required when auth_type is oidc_aws.
body.role_name string Optional The AWS IAM role name. Required when auth_type is oidc_aws.
body.domain string Optional The CodeArtifact domain. Required when auth_type is oidc_aws.
body.domain_owner string Optional The CodeArtifact domain owner (AWS account ID). Required when auth_type is oidc_aws.
body.jfrog_oidc_provider_name string Optional The JFrog OIDC provider name. Required when auth_type is oidc_jfrog.
body.audience string Optional The OIDC audience. Optional for oidc_aws, oidc_jfrog, and oidc_gcp, and required for oidc_cloudsmith auth types.
body.identity_mapping_name string Optional The JFrog identity mapping name. Optional for oidc_jfrog auth type.
body.namespace string Optional The Cloudsmith organization namespace. Required when auth_type is oidc_cloudsmith.
body.service_slug string Optional The Cloudsmith service account slug. Required when auth_type is oidc_cloudsmith.
body.api_host string Optional The Cloudsmith API host. Optional for oidc_cloudsmith auth type. If omitted, api.cloudsmith.io is used by default.
body.workload_identity_provider string Optional The full resource name of the GCP Workload Identity Provider (e.g. projects/<NUM>/locations/global/workloadIdentityPools/<POOL>/providers/<PROVIDER>). Required when auth_type is oidc_gcp.
body.service_account string Optional The GCP service account email to impersonate. Optional for oidc_gcp auth type. If omitted, the federated token is used directly (direct WIF).

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "registry_type": "maven_repository",
    "url": "https://maven.pkg.github.com/organization/",
    "username": "monalisa",
    "replaces_base": true,
    "encrypted_value": "c2VjcmV0",
    "key_id": "012345678912345678",
    "visibility": "private"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get private registries public key for an organization — github.private-registries.get-org-public-key

Run Get private registries public key for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a private registry for an organization — github.private-registries.get-org-private-registry

Run Get a private registry for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a private registry for an organization — github.private-registries.update-org-private-registry

Run Update a private registry for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.
body object Required
body.registry_type string Optional The registry type. enum: ["maven_repository","nuget_feed","goproxy_server","npm_registry","rubygems_server","cargo_registry","composer_repository","docker_registry","git_source","helm_registry","hex_organization","hex_repository","pub_repository","python_index","terraform_registry"]
body.url string Optional The URL of the private registry. format: "uri"
body.username string | null Optional The username to use when authenticating with the private registry. This field should be omitted if the private registry does not require a username for authentication.
body.replaces_base boolean Optional Whether this private registry should replace the base registry (e.g., npmjs.org for npm, rubygems.org for rubygems). When set to true, Dependabot will only use this registry and will not fall back to the public registry. When set to false (default), Dependabot will use this registry for scoped packages but may fall back to the public registry for other packages. default: false
body.encrypted_value string Optional The value for your secret, encrypted with LibSodium using the public key retrieved from the Get private registries public key for an organization endpoint. pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$"
body.key_id string Optional The ID of the key you used to encrypt the secret.
body.visibility string Optional Which type of organization repositories have access to the private registry. selected means only the repositories specified by selected_repository_ids can access the private registry. enum: ["all","private","selected"]
body.selected_repository_ids array Optional An array of repository IDs that can access the organization private registry. You can only provide a list of repository IDs when visibility is set to selected. This field should be omitted if visibility is set to all or private.
body.selected_repository_ids[] integer Optional
body.auth_type string Optional The authentication type for the private registry. This field cannot be changed after creation. If provided, it must match the existing auth_type of the configuration. To change the authentication type, delete and recreate the configuration. enum: ["token","username_password","oidc_azure","oidc_aws","oidc_jfrog","oidc_cloudsmith","oidc_gcp","anonymous"]
body.tenant_id string Optional The tenant ID of the Azure AD application. Required when auth_type is oidc_azure.
body.client_id string Optional The client ID of the Azure AD application. Required when auth_type is oidc_azure.
body.aws_region string Optional The AWS region. Required when auth_type is oidc_aws.
body.account_id string Optional The AWS account ID. Required when auth_type is oidc_aws.
body.role_name string Optional The AWS IAM role name. Required when auth_type is oidc_aws.
body.domain string Optional The CodeArtifact domain. Required when auth_type is oidc_aws.
body.domain_owner string Optional The CodeArtifact domain owner (AWS account ID). Required when auth_type is oidc_aws.
body.jfrog_oidc_provider_name string Optional The JFrog OIDC provider name. Required when auth_type is oidc_jfrog.
body.audience string Optional The OIDC audience. Optional for oidc_aws, oidc_jfrog, and oidc_gcp, and required for oidc_cloudsmith auth types.
body.identity_mapping_name string Optional The JFrog identity mapping name. Optional for oidc_jfrog auth type.
body.namespace string Optional The Cloudsmith organization namespace. Required when auth_type is oidc_cloudsmith.
body.service_slug string Optional The Cloudsmith service account slug. Required when auth_type is oidc_cloudsmith.
body.api_host string Optional The Cloudsmith API host. Optional for oidc_cloudsmith auth type. If omitted, api.cloudsmith.io is used by default.
body.workload_identity_provider string Optional The full resource name of the GCP Workload Identity Provider (e.g. projects/<NUM>/locations/global/workloadIdentityPools/<POOL>/providers/<PROVIDER>). Required when auth_type is oidc_gcp.
body.service_account string Optional The GCP service account email to impersonate. Optional for oidc_gcp auth type. If omitted, the federated token is used directly (direct WIF).

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  },
  "body": {
    "username": "monalisa",
    "encrypted_value": "c2VjcmV0",
    "key_id": "012345678912345678"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a private registry for an organization — github.private-registries.delete-org-private-registry

Run Delete a private registry for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List projects for organization — github.projects.list-for-org

Run List projects for organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.q string Optional Limit results to projects of the specified type.
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get project for organization — github.projects.get-for-org

Run Get project for organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.project_number integer Required The project's number.
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "project_number": 1,
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create draft item for organization owned project — github.projects.create-draft-item-for-org

Run Create draft item for organization owned project with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.project_number integer Required The project's number.
body object Required
body.title string Required The title of the draft issue item to create in the project.
body.body string Optional The body content of the draft issue item to create in the project.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "project_number": 1
  },
  "body": {
    "title": "Sample Draft Issue Title"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List project fields for organization — github.projects.list-fields-for-org

Run List project fields for organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.project_number integer Required The project's number.
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "project_number": 1,
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add a field to an organization-owned project. — github.projects.add-field-for-org

Run Add a field to an organization-owned project. with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.project_number integer Required The project's number.
path.org string Required The organization name. The name is not case sensitive.
body — Required
body object Required oneOf[1]; additionalProperties: false
body.issue_field_id integer Required The ID of the IssueField to create the field for. oneOf[1]
body object Required oneOf[2]; additionalProperties: false
body.name string Required The name of the field. oneOf[2]
body.data_type string Required The field's data type. oneOf[2]; enum: ["text","number","date"]
body object Required oneOf[3]; additionalProperties: false
body.name string Required The name of the field. oneOf[3]
body.data_type string Required The field's data type. oneOf[3]; enum: ["single_select"]
body.single_select_options array Required The options available for single select fields. At least one option must be provided when creating a single select field. oneOf[3]
body.single_select_options[] — Optional oneOf[3]; $ref: "#/definitions/projects-v2-field-single-select-option"
body object Required oneOf[4]; additionalProperties: false
body.name string Required The name of the field. oneOf[4]
body.data_type string Required The field's data type. oneOf[4]; enum: ["iteration"]
body.iteration_configuration — Required oneOf[4]; $ref: "#/definitions/projects-v2-field-iteration-configuration"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "project_number": 1,
    "org": "example"
  },
  "body": {
    "name": "Team notes",
    "data_type": "text"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get project field for organization — github.projects.get-field-for-org

Run Get project field for organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.project_number integer Required The project's number.
path.field_id integer Required The unique identifier of the field.
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "project_number": 1,
    "field_id": 1,
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List items for an organization owned project — github.projects.list-items-for-org

Run List items for an organization owned project with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.project_number integer Required The project's number.
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.q string Optional Search query to filter items, see Filtering projects for more information.
query.fields — Optional Limit results to specific fields, by their IDs. If not specified, the title field will be returned. Example: fields[]=123&fields[]=456&fields[]=789 or fields=123,456,789
query.fields string Optional oneOf[1]
query.fields array Optional oneOf[2]; maxItems: 50
query.fields[] string Optional oneOf[2]
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "project_number": 1,
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add item to organization owned project — github.projects.add-item-for-org

Run Add item to organization owned project with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.project_number integer Required The project's number.
body object Required additionalProperties: false
body.type string Required The type of item to add to the project. Must be either Issue or PullRequest. enum: ["Issue","PullRequest"]
body.id integer Optional The unique identifier of the issue or pull request to add to the project.
body.owner string Optional The repository owner login.
body.repo string Optional The repository name.
body.number integer Optional The issue or pull request number.
body — Required oneOf[1]
body — Required oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "project_number": 1
  },
  "body": {
    "type": "Issue",
    "id": 3
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an item for an organization owned project — github.projects.get-org-item

Run Get an item for an organization owned project with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.project_number integer Required The project's number.
path.org string Required The organization name. The name is not case sensitive.
path.item_id integer Required The unique identifier of the project item.
query object Optional additionalProperties: false
query.fields — Optional Limit results to specific fields, by their IDs. If not specified, the title field will be returned. Example: fields[]=123&fields[]=456&fields[]=789 or fields=123,456,789
query.fields string Optional oneOf[1]
query.fields array Optional oneOf[2]; maxItems: 50
query.fields[] string Optional oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "project_number": 1,
    "org": "example",
    "item_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update project item for organization — github.projects.update-item-for-org

Run Update project item for organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.project_number integer Required The project's number.
path.org string Required The organization name. The name is not case sensitive.
path.item_id integer Required The unique identifier of the project item.
body object Required
body.fields array Required A list of field updates to apply.
body.fields[] object Optional
body.fields[].id integer Required The ID of the project field to update.
body.fields[].value — Required The new value for the field: - For text, number, and date fields, provide the new value directly. - For single select and iteration fields, provide the ID of the option or iteration. - To clear the field, set this to null.
body.fields[].value string Required oneOf[1]
body.fields[].value number Required oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "project_number": 1,
    "org": "example",
    "item_id": 1
  },
  "body": {
    "fields": [
      {
        "id": 123,
        "value": "Updated text value"
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete project item for organization — github.projects.delete-item-for-org

Run Delete project item for organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.project_number integer Required The project's number.
path.org string Required The organization name. The name is not case sensitive.
path.item_id integer Required The unique identifier of the project item.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "project_number": 1,
    "org": "example",
    "item_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a view for an organization-owned project — github.projects.create-view-for-org

Run Create a view for an organization-owned project with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.project_number integer Required The project's number.
body object Required additionalProperties: false
body.name string Required The name of the view.
body.layout string Required The layout of the view. enum: ["table","board","roadmap"]
body.filter string Optional The filter query for the view. See Filtering projects for more information.
body.visible_fields array Optional visible_fields is not applicable to roadmap layout views. For table and board layouts, this represents the field IDs that should be visible in the view. If not provided, the default visible fields will be used.
body.visible_fields[] integer Optional
body.sort_by array Optional Sorting configuration for the view. Each element is a two-element array of [field_id, direction] where direction is "asc" or "desc". Supports multiple sort criteria applied in order.
body.sort_by[] array Optional minItems: 2; maxItems: 2
body.sort_by[][] — Optional
body.sort_by[][] integer Optional oneOf[1]
body.sort_by[][] string Optional oneOf[2]
body.group_by array Optional The field IDs to group items by (horizontal grouping). Supports a single field. The field must support grouping; fields such as Title, Reviewers, Linked pull requests, Sub-issues progress, Tracked by, and Tracks cannot be grouped on. maxItems: 1
body.group_by[] integer Optional
body.vertical_group_by array Optional The field IDs to use as columns in board layout (vertical grouping). Supports a single field. The field must support grouping; fields such as Title, Reviewers, Linked pull requests, Sub-issues progress, Tracked by, and Tracks cannot be grouped on. maxItems: 1
body.vertical_group_by[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "project_number": 1
  },
  "body": {
    "name": "All Issues",
    "layout": "table",
    "filter": "is:issue",
    "visible_fields": [
      123,
      456,
      789
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List items for an organization project view — github.projects.list-view-items-for-org

Run List items for an organization project view with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.project_number integer Required The project's number.
path.org string Required The organization name. The name is not case sensitive.
path.view_number integer Required The number that identifies the project view.
query object Optional additionalProperties: false
query.fields — Optional Limit results to specific fields, by their IDs. If not specified, the title field will be returned. Example: fields[]=123&fields[]=456&fields[]=789 or fields=123,456,789
query.fields string Optional oneOf[1]
query.fields array Optional oneOf[2]; maxItems: 50
query.fields[] string Optional oneOf[2]
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "project_number": 1,
    "org": "example",
    "view_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get registered app installations for external custom properties — github.orgs.external-properties-for-repos-get-organization-app-installations

Run Get registered app installations for external custom properties with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Register an app installation for external custom properties — github.orgs.external-properties-for-repos-register-organization-app-installation

Run Register an app installation for external custom properties with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.installation_id integer Optional The unique identifier of the GitHub App installation to register for managing external custom properties. When authenticating as a GitHub App installation, this defaults to the authenticated installation and can be omitted. It is required for all other callers (users and fine-grained personal access tokens).
body.display_name string Required The display name for this app installation's external custom properties in the organization. Must be 1 to 15 characters and contain only letters and numbers. Capitalization is preserved as entered. This can't be changed after the app installation is registered. minLength: 1; maxLength: 15; pattern: "^[a-zA-Z0-9]+$"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "installation_id": 67890,
    "display_name": "Acme"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get all external custom properties for a GitHub App installation in an organization — github.orgs.external-properties-for-repos-get-organization-definitions

Run Get all external custom properties for a GitHub App installation in an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update external custom property values for organization repositories — github.orgs.external-properties-for-repos-create-or-update-organization-values

Run Create or update external custom property values for organization repositories with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.repository_names array Required The names of repositories that the external custom property values will be applied to. minItems: 1; maxItems: 30
body.repository_names[] string Optional
body.properties array Required List of external custom property names and associated values to apply to the repositories.
body.properties[] — Optional $ref: "#/definitions/custom-property-value"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "repository_names": [
      "example"
    ],
    "properties": []
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update external custom property values for a property across organization repositories — github.orgs.external-properties-for-repos-create-or-update-values-for-6035de2edd

Run Create or update external custom property values for a property across organization repositories with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.property_name string Required The name of the external custom property
body object Required
body.repository_values array Required The names of repositories and the values that the named external custom property will be set to. minItems: 1; maxItems: 100
body.repository_values[] — Optional $ref: "#/definitions/repository-external-property-payload"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "property_name": "example"
  },
  "body": {
    "repository_values": [
      {
        "repository_name": "example",
        "value": "example"
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove all external custom property values for a property across all organization repositories — github.orgs.external-properties-for-repos-delete-organization-values

Run Remove all external custom property values for a property across all organization repositories with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.property_name string Required The name of the external custom property

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "property_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get all custom properties for an organization — github.orgs.custom-properties-for-repos-get-organization-definitions

Run Get all custom properties for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update custom properties for an organization — github.orgs.custom-properties-for-repos-create-or-update-organization-ed341b3e2b

Run Create or update custom properties for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.properties array Required The array of custom properties to create or update. minItems: 1; maxItems: 100
body.properties[] — Optional $ref: "#/definitions/custom-property"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "properties": [
      {
        "property_name": "environment",
        "value_type": "single_select",
        "required": true,
        "default_value": "production",
        "description": "Prod or dev environment",
        "allowed_values": [
          "production",
          "development"
        ],
        "values_editable_by": "org_actors"
      },
      {
        "property_name": "service",
        "value_type": "string"
      },
      {
        "property_name": "team",
        "value_type": "string",
        "description": "Team owning the repository"
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a custom property for an organization — github.orgs.custom-properties-for-repos-get-organization-definition

Run Get a custom property for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.custom_property_name string Required The custom property name

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "custom_property_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update a custom property for an organization — github.orgs.custom-properties-for-repos-create-or-update-organization-definition

Run Create or update a custom property for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.custom_property_name string Required The custom property name
body — Required $ref: "#/definitions/custom-property-set-payload"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "custom_property_name": "example"
  },
  "body": {
    "value_type": "single_select"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove a custom property for an organization — github.orgs.custom-properties-for-repos-delete-organization-definition

Run Remove a custom property for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.custom_property_name string Required The custom property name

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "custom_property_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List custom property values for organization repositories — github.orgs.custom-properties-for-repos-get-organization-values

Run List custom property values for organization repositories with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.repository_query string Optional Finds repositories in the organization with a query containing one or more search keywords and qualifiers. Qualifiers allow you to limit your search to specific areas of GitHub. The REST API supports the same qualifiers as the web interface for GitHub. To learn more about the format of the query, see Constructing a search query. See "Searching for repositories" for a detailed list of qualifiers.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update custom property values for organization repositories — github.orgs.custom-properties-for-repos-create-or-update-organization-values

Run Create or update custom property values for organization repositories with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.repository_names array Required The names of repositories that the custom property values will be applied to. minItems: 1; maxItems: 30
body.repository_names[] string Optional
body.properties array Required List of custom property names and associated values to apply to the repositories.
body.properties[] — Optional $ref: "#/definitions/custom-property-value"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "repository_names": [
      "example"
    ],
    "properties": []
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List public organization members — github.orgs.list-public-members

Run List public organization members with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check public organization membership for a user — github.orgs.check-public-membership-for-user

Run Check public organization membership for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set public organization membership for the authenticated user — github.orgs.set-public-membership-for-authenticated-user

Run Set public organization membership for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove public organization membership for the authenticated user — github.orgs.remove-public-membership-for-authenticated-user

Run Remove public organization membership for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization repositories — github.repos.list-for-org

Run List organization repositories with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.type string Optional Specifies the types of repositories you want returned. enum: ["all","public","private","forks","sources","member"]; default: "all"
query.sort string Optional The property to sort the results by. enum: ["created","updated","pushed","full_name"]; default: "created"
query.direction string Optional The order to sort by. Default: asc when using full_name, otherwise desc. enum: ["asc","desc"]
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an organization repository — github.repos.create-in-org

Run Create an organization repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.name string Required The name of the repository.
body.description string Optional A short description of the repository.
body.homepage string Optional A URL with more information about the repository.
body.private boolean Optional Whether the repository is private. default: false
body.visibility string Optional The visibility of the repository. enum: ["public","private"]
body.has_issues boolean Optional Either true to enable issues for this repository or false to disable them. default: true
body.has_projects boolean Optional Either true to enable projects for this repository or false to disable them. Note: If you're creating a repository in an organization that has disabled repository projects, the default is false, and if you pass true, the API returns an error. default: true
body.has_wiki boolean Optional Either true to enable the wiki for this repository or false to disable it. default: true
body.has_downloads boolean Optional Whether downloads are enabled. default: true
body.is_template boolean Optional Either true to make this repo available as a template repository or false to prevent it. default: false
body.team_id integer Optional The id of the team that will be granted access to this repository. This is only valid when creating a repository in an organization.
body.auto_init boolean Optional Pass true to create an initial commit with empty README. default: false
body.gitignore_template string Optional Desired language or platform .gitignore template to apply. Use the name of the template without the extension. For example, "Haskell".
body.license_template string Optional Choose an open source license template that best suits your needs, and then use the license keyword as the license_template string. For example, "mit" or "mpl-2.0".
body.allow_squash_merge boolean Optional Either true to allow squash-merging pull requests, or false to prevent squash-merging. default: true
body.allow_merge_commit boolean Optional Either true to allow merging pull requests with a merge commit, or false to prevent merging pull requests with merge commits. default: true
body.allow_rebase_merge boolean Optional Either true to allow rebase-merging pull requests, or false to prevent rebase-merging. default: true
body.allow_auto_merge boolean Optional Either true to allow auto-merge on pull requests, or false to disallow auto-merge. default: false
body.delete_branch_on_merge boolean Optional Either true to allow automatically deleting head branches when pull requests are merged, or false to prevent automatic deletion. The authenticated user must be an organization owner to set this property to true. default: false
body.use_squash_pr_title_as_default boolean Optional Either true to allow squash-merge commits to use pull request title, or false to use commit message. **This property is closing down. Please use squash_merge_commit_title instead. default: false
body.squash_merge_commit_title string Optional Required when using squash_merge_commit_message. The default value for a squash merge commit title: - PR_TITLE - default to the pull request's title. - COMMIT_OR_PR_TITLE - default to the commit's title (if only one commit) or the pull request's title (when more than one commit). enum: ["PR_TITLE","COMMIT_OR_PR_TITLE"]
body.squash_merge_commit_message string Optional The default value for a squash merge commit message: - PR_BODY - default to the pull request's body. - COMMIT_MESSAGES - default to the branch's commit messages. - BLANK - default to a blank commit message. enum: ["PR_BODY","COMMIT_MESSAGES","BLANK"]
body.merge_commit_title string Optional Required when using merge_commit_message. The default value for a merge commit title. - PR_TITLE - default to the pull request's title. - MERGE_MESSAGE - default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name). enum: ["PR_TITLE","MERGE_MESSAGE"]
body.merge_commit_message string Optional The default value for a merge commit message. - PR_TITLE - default to the pull request's title. - PR_BODY - default to the pull request's body. - BLANK - default to a blank commit message. enum: ["PR_BODY","PR_TITLE","BLANK"]
body.custom_properties object Optional The custom properties for the new repository. The keys are the custom property names, and the values are the corresponding custom property values. additionalProperties: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "Hello-World",
    "description": "This is your first repository",
    "homepage": "https://github.com",
    "private": false,
    "has_issues": true,
    "has_projects": true,
    "has_wiki": true
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get all organization repository rulesets — github.repos.get-org-rulesets

Run Get all organization repository rulesets with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.targets string Optional A comma-separated list of rule targets to filter by. If provided, only rulesets that apply to the specified targets will be returned. For example, branch,tag,push.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an organization repository ruleset — github.repos.create-org-ruleset

Run Create an organization repository ruleset with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.name string Required The name of the ruleset.
body.target string Optional The target of the ruleset enum: ["branch","tag","push","repository"]; default: "branch"
body.enforcement — Required $ref: "#/definitions/repository-rule-enforcement"
body.bypass_actors array Optional The actors that can bypass the rules in this ruleset
body.bypass_actors[] — Optional $ref: "#/definitions/repository-ruleset-bypass-actor"
body.conditions — Optional $ref: "#/definitions/org-ruleset-conditions"
body.rules array Optional An array of rules within the ruleset.
body.rules[] — Optional $ref: "#/definitions/org-rules"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "super cool ruleset",
    "target": "branch",
    "enforcement": "active",
    "bypass_actors": [
      {
        "actor_id": 234,
        "actor_type": "Team",
        "bypass_mode": "always"
      }
    ],
    "conditions": {
      "ref_name": {
        "include": [
          "refs/heads/main",
          "refs/heads/master"
        ],
        "exclude": [
          "refs/heads/dev*"
        ]
      },
      "repository_name": {
        "include": [
          "important_repository",
          "another_important_repository"
        ],
        "exclude": [
          "unimportant_repository"
        ],
        "protected": true
      }
    },
    "rules": [
      {
        "type": "commit_author_email_pattern",
        "parameters": {
          "operator": "contains",
          "pattern": "github"
        }
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization rule suites — github.repos.get-org-rule-suites

Run List organization rule suites with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.ref string Optional The name of the ref. Cannot contain wildcard characters. Optionally prefix with refs/heads/ to limit to branches or refs/tags/ to limit to tags. Omit the prefix to search across all refs. When specified, only rule evaluations triggered for this ref will be returned.
query.repository_name string Optional The name of the repository to filter on.
query.time_period string Optional The time period to filter by. For example, day will filter for rule suites that occurred in the past 24 hours, and week will filter for rule suites that occurred in the past 7 days (168 hours). enum: ["hour","day","week","month"]; default: "day"
query.actor_name string Optional The handle for the GitHub user account to filter on. When specified, only rule evaluations triggered by this actor will be returned.
query.rule_suite_result string Optional The rule suite results to filter on. When specified, only suites with this result will be returned. enum: ["pass","fail","bypass","all"]; default: "all"
query.evaluate_status string Optional The evaluate status to filter on. When specified, only rule suites resulting from rulesets with the specified evaluate status will be returned. - all - all rule suites will be returned. - active - only rule suites resulting from rulesets in active (non-evaluate) mode will be returned. - evaluate - only rule suites resulting from rulesets in evaluate mode will be returned. enum: ["all","active","evaluate"]; default: "all"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization rule suite — github.repos.get-org-rule-suite

Run Get an organization rule suite with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.rule_suite_id integer Required The unique identifier of the rule suite result. To get this ID, you can use GET /repos/{owner}/{repo}/rulesets/rule-suites for repositories and GET /orgs/{org}/rulesets/rule-suites for organizations.
query object Optional additionalProperties: false
query.include_metadata boolean Optional When set to true, the response will include additional metadata for pull request and required status check rule evaluation. Results are capped at 50 entries. default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "rule_suite_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization repository ruleset — github.repos.get-org-ruleset

Run Get an organization repository ruleset with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.ruleset_id integer Required The ID of the ruleset.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "ruleset_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update an organization repository ruleset — github.repos.update-org-ruleset

Run Update an organization repository ruleset with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.ruleset_id integer Required The ID of the ruleset.
body object Optional
body.name string Optional The name of the ruleset.
body.target string Optional The target of the ruleset enum: ["branch","tag","push","repository"]
body.enforcement — Optional $ref: "#/definitions/repository-rule-enforcement"
body.bypass_actors array Optional The actors that can bypass the rules in this ruleset
body.bypass_actors[] — Optional $ref: "#/definitions/repository-ruleset-bypass-actor"
body.conditions — Optional $ref: "#/definitions/org-ruleset-conditions"
body.rules array Optional An array of rules within the ruleset.
body.rules[] — Optional $ref: "#/definitions/org-rules"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "ruleset_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an organization repository ruleset — github.repos.delete-org-ruleset

Run Delete an organization repository ruleset with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.ruleset_id integer Required The ID of the ruleset.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "ruleset_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get organization ruleset history — github.orgs.get-org-ruleset-history

Run Get organization ruleset history with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.ruleset_id integer Required The ID of the ruleset.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "ruleset_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get organization ruleset version — github.orgs.get-org-ruleset-version

Run Get organization ruleset version with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.ruleset_id integer Required The ID of the ruleset.
path.version_id integer Required The ID of the version

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "ruleset_id": 1,
    "version_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List secret scanning alerts for an organization — github.secret-scanning.list-alerts-for-org

Run List secret scanning alerts for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.state string Optional Set to open or resolved to only list secret scanning alerts in a specific state. enum: ["open","resolved"]
query.secret_type string Optional A comma-separated list of secret types to return. All default secret patterns are returned. To return generic patterns, pass the token name(s) in the parameter. See "Supported secret scanning patterns" for a complete list of secret types.
query.exclude_secret_types string Optional A comma-separated list of secret types to exclude from the results. All default secret patterns are returned except those matching the specified types. Cannot be combined with the secret_type parameter. See "Supported secret scanning patterns" for a complete list of secret types.
query.exclude_providers string Optional A comma-separated list of provider slugs to exclude from the results. Provider slugs use lowercase with underscores (e.g., github_secret_scanning, clojars). You can find the provider slug in the provider_slug field of each alert. Cannot be combined with the providers parameter.
query.providers string Optional A comma-separated list of provider slugs to filter by. Provider slugs use lowercase with underscores (e.g., github_secret_scanning, clojars). You can find the provider slug in the provider_slug field of each alert. Cannot be combined with the exclude_providers parameter.
query.resolution string Optional A comma-separated list of resolutions. Only secret scanning alerts with one of these resolutions are listed. Valid resolutions are false_positive, wont_fix, revoked, pattern_edited, pattern_deleted or used_in_tests.
query.assignee string Optional Filters alerts by assignee. Use * to get all assigned alerts, none to get all unassigned alerts, or a GitHub username to get alerts assigned to a specific user.
query.sort string Optional The property to sort the results by. created means when the alert was created. updated means when the alert was updated or resolved. enum: ["created","updated"]; default: "created"
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for events before this cursor. To receive an initial cursor on your first request, include an empty "before" query string.
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for events after this cursor. To receive an initial cursor on your first request, include an empty "after" query string.
query.validity string Optional A comma-separated list of validities that, when present, will return alerts that match the validities in this list. Valid options are active, inactive, and unknown.
query.is_publicly_leaked boolean Optional A boolean value representing whether or not to filter alerts by the publicly-leaked tag being present. default: false
query.is_multi_repo boolean Optional A boolean value representing whether or not to filter alerts by the multi-repo tag being present. default: false
query.hide_secret boolean Optional A boolean value representing whether or not to hide literal secrets in the results. default: false
query.is_bypassed boolean Optional A boolean value (true or false) indicating whether to filter alerts by their push protection bypass status. When set to true, only alerts that were created because a push protection rule was bypassed will be returned. When set to false, only alerts that were not caused by a push protection bypass will be returned.
query.included_metadata string Optional A comma-separated list of metadata fields to filter alerts by. Only alerts that have all of the specified metadata fields attached will be returned. Possible values are: owner-email, owner-id, owner-name, secret-id, secret-name, secret-issued-date, secret-expiration-date, organization-name, organization-id, last-used-date, and has-organization-access.
query.owner_email_hash string Optional Filters alerts to only those whose attached owner_email metadata field matches the provided value. The value must be the lowercase hex-encoded SHA-256 hash of the email address to match (for example, the SHA-256 of [email protected]). Only alerts that have an owner_email metadata value whose SHA-256 hash equals this parameter are returned.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization custom patterns — github.secret-scanning.list-org-custom-patterns

Run List organization custom patterns with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.state string Optional Filter custom patterns by state. When absent, returns patterns in all states. enum: ["published","unpublished"]
query.push_protection string Optional Filter custom patterns by whether push protection is enabled. When absent, returns patterns regardless of push protection status. enum: ["enabled","disabled"]
query.sort string Optional The property to sort the results by. enum: ["created","updated","name"]; default: "created"
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Bulk create organization custom patterns — github.secret-scanning.bulk-create-org-custom-patterns

Run Bulk create organization custom patterns with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.patterns array Required The list of custom patterns to create (maximum 100). maxItems: 100
body.patterns[] — Optional $ref: "#/definitions/secret-scanning-custom-pattern-to-create"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "patterns": []
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Bulk delete organization custom patterns — github.secret-scanning.bulk-delete-org-custom-patterns

Run Bulk delete organization custom patterns with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.patterns array Required The list of custom patterns to delete. maxItems: 500
body.patterns[] — Optional $ref: "#/definitions/secret-scanning-custom-pattern-to-delete"
body.post_delete_action string Optional What to do with alerts associated with the deleted patterns. delete_alerts permanently removes the alerts. resolve_alerts resolves the alerts as "pattern deleted". Defaults to delete_alerts when not specified. enum: ["delete_alerts","resolve_alerts"]; default: "delete_alerts"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "patterns": []
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update an organization custom pattern — github.secret-scanning.update-org-custom-pattern

Run Update an organization custom pattern with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.pattern_id integer Required The ID of the custom pattern.
body — Required $ref: "#/definitions/secret-scanning-custom-pattern-to-update"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "pattern_id": 1
  },
  "body": {
    "custom_pattern_version": "example",
    "pattern": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization pattern configurations — github.secret-scanning.list-org-pattern-configs

Run List organization pattern configurations with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update organization pattern configurations — github.secret-scanning.update-org-pattern-configs

Run Update organization pattern configurations with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.pattern_config_version — Optional $ref: "#/definitions/secret-scanning-row-version"
body.provider_pattern_settings array Optional Pattern settings for provider patterns.
body.provider_pattern_settings[] object Optional
body.provider_pattern_settings[].token_type string Optional The ID of the pattern to configure.
body.provider_pattern_settings[].push_protection_setting string Optional Push protection setting to set for the pattern. enum: ["not-set","disabled","enabled"]
body.custom_pattern_settings array Optional Pattern settings for custom patterns.
body.custom_pattern_settings[] object Optional
body.custom_pattern_settings[].token_type string Optional The ID of the pattern to configure.
body.custom_pattern_settings[].custom_pattern_version — Optional $ref: "#/definitions/secret-scanning-row-version"
body.custom_pattern_settings[].push_protection_setting string Optional Push protection setting to set for the pattern. enum: ["disabled","enabled"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "pattern_config_version": "0ujsswThIGTUYm2K8FjOOfXtY1K",
    "provider_pattern_settings": [
      {
        "token_type": "GITHUB_PERSONAL_ACCESS_TOKEN",
        "push_protection_setting": "enabled"
      }
    ],
    "custom_pattern_settings": [
      {
        "token_type": "cp_2",
        "custom_pattern_version": "0ujsswThIGTUYm2K8FjOOfXtY1K",
        "push_protection_setting": "enabled"
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository security advisories for an organization — github.security-advisories.list-org-repository-advisories

Run List repository security advisories for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.sort string Optional The property to sort the results by. enum: ["created","updated","published"]; default: "created"
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.per_page integer Optional The number of advisories to return per page. For more information, see "Using pagination in the REST API." default: 30; minimum: 1; maximum: 100
query.state string Optional Filter by the state of the repository advisories. Only advisories of this state will be returned. enum: ["triage","draft","published","closed"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get immutable releases settings for an organization — github.orgs.get-immutable-releases-settings

Run Get immutable releases settings for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set immutable releases settings for an organization — github.orgs.set-immutable-releases-settings

Run Set immutable releases settings for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.enforced_repositories string Required The policy that controls how immutable releases are enforced in the organization. enum: ["all","none","selected"]
body.selected_repository_ids array Optional An array of repository ids for which immutable releases enforcement should be applied. You can only provide a list of repository ids when the enforced_repositories is set to selected. You can add and remove individual repositories using the Enable a selected repository for immutable releases in an organization and Disable a selected repository for immutable releases in an organization endpoints.
body.selected_repository_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "enforced_repositories": "all"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List selected repositories for immutable releases enforcement — github.orgs.get-immutable-releases-settings-repositories

Run List selected repositories for immutable releases enforcement with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set selected repositories for immutable releases enforcement — github.orgs.set-immutable-releases-settings-repositories

Run Set selected repositories for immutable releases enforcement with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.selected_repository_ids array Required An array of repository ids for which immutable releases enforcement should be applied. You can only provide a list of repository ids when the enforced_repositories is set to selected. You can add and remove individual repositories using the Enable a selected repository for immutable releases in an organization and Disable a selected repository for immutable releases in an organization endpoints.
body.selected_repository_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "selected_repository_ids": [
      64780797
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Enable a selected repository for immutable releases in an organization — github.orgs.enable-selected-repository-immutable-releases-organization

Run Enable a selected repository for immutable releases in an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.repository_id integer Required The unique identifier of the repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Disable a selected repository for immutable releases in an organization — github.orgs.disable-selected-repository-immutable-releases-organization

Run Disable a selected repository for immutable releases in an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.repository_id integer Required The unique identifier of the repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List hosted compute network configurations for an organization — github.hosted-compute.list-network-configurations-for-org

Run List hosted compute network configurations for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a hosted compute network configuration for an organization — github.hosted-compute.create-network-configuration-for-org

Run Create a hosted compute network configuration for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.name string Required Name of the network configuration. Must be between 1 and 100 characters and may only contain upper and lowercase letters a-z, numbers 0-9, '.', '-', and '_'.
body.compute_service string Optional The hosted compute service to use for the network configuration. enum: ["none","actions"]
body.network_settings_ids array Required A list of identifiers of the network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list. minItems: 1; maxItems: 1
body.network_settings_ids[] string Optional
body.failover_network_settings_ids array Optional A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list. minItems: 0; maxItems: 1
body.failover_network_settings_ids[] string Optional
body.failover_network_enabled boolean Optional Indicates whether the failover network resource is enabled.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "my-network-configuration",
    "network_settings_ids": [
      "23456789ABDCEF1"
    ],
    "compute_service": "actions"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a hosted compute network configuration for an organization — github.hosted-compute.get-network-configuration-for-org

Run Get a hosted compute network configuration for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.network_configuration_id string Required Unique identifier of the hosted compute network configuration.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "network_configuration_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a hosted compute network configuration for an organization — github.hosted-compute.update-network-configuration-for-org

Run Update a hosted compute network configuration for an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.network_configuration_id string Required Unique identifier of the hosted compute network configuration.
body object Required
body.name string Optional Name of the network configuration. Must be between 1 and 100 characters and may only contain upper and lowercase letters a-z, numbers 0-9, '.', '-', and '_'.
body.compute_service string Optional The hosted compute service to use for the network configuration. enum: ["none","actions"]
body.network_settings_ids array Optional A list of identifiers of the network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list. minItems: 0; maxItems: 1
body.network_settings_ids[] string Optional
body.failover_network_settings_ids array Optional A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list. minItems: 0; maxItems: 1
body.failover_network_settings_ids[] string Optional
body.failover_network_enabled boolean Optional Indicates whether the failover network resource is enabled.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "network_configuration_id": "example"
  },
  "body": {
    "name": "my-network-configuration",
    "network_settings_ids": [
      "23456789ABDCEF1"
    ],
    "compute_service": "actions"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a hosted compute network configuration from an organization — github.hosted-compute.delete-network-configuration-from-org

Run Delete a hosted compute network configuration from an organization with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.network_configuration_id string Required Unique identifier of the hosted compute network configuration.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "network_configuration_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a hosted compute network settings resource for an organization — github.hosted-compute.get-network-settings-for-org

Run Get a hosted compute network settings resource for an organization with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.network_settings_id string Required Unique identifier of the hosted compute network settings.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "network_settings_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List teams — github.teams.list

Run List teams with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.team_type string Optional Filter team results by their type. For more information, see "What kind of team should I use?" enum: ["all","enterprise","organization"]; default: "all"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a team — github.teams.create

Run Create a team with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.name string Required The name of the team.
body.description string Optional The description of the team.
body.maintainers array Optional List GitHub usernames for organization members who will become team maintainers.
body.maintainers[] string Optional
body.repo_names array Optional The full name (e.g., "organization-name/repository-name") of repositories to add the team to.
body.repo_names[] string Optional
body.privacy string Optional The level of privacy this team should have. The options are: For a non-nested team: * secret - only visible to organization owners and members of this team. * closed - visible to all members of this organization. Default: secret For a parent or child team: * closed - visible to all members of this organization. Default for child team: closed enum: ["secret","closed"]
body.notification_setting string Optional The notification setting the team has chosen. The options are: * notifications_enabled - team members receive notifications when the team is @mentioned. * notifications_disabled - no one receives notifications. Default: notifications_enabled enum: ["notifications_enabled","notifications_disabled"]
body.permission string Optional Closing down notice. The permission that new repositories will be added to the team with when none is specified. enum: ["pull","push"]; default: "pull"
body.parent_team_id integer Optional The ID of a team to set as the parent team.
body.parent_team_slug string Optional The slug of a team to set as the parent team. Ignored when parent_team_id is also provided.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "name": "Justice League",
    "description": "A great team",
    "permission": "push",
    "notification_setting": "notifications_enabled",
    "privacy": "closed"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a team by name — github.teams.get-by-name

Run Get a team by name with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.team_slug string Required The slug of the team name.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "team_slug": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a team — github.teams.update-in-org

Run Update a team with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.team_slug string Required The slug of the team name.
body object Optional
body.name string Optional The name of the team.
body.description string Optional The description of the team.
body.privacy string Optional The level of privacy this team should have. Editing teams without specifying this parameter leaves privacy intact. When a team is nested, the privacy for parent teams cannot be secret. The options are: For a non-nested team: * secret - only visible to organization owners and members of this team. * closed - visible to all members of this organization. For a parent or child team: * closed - visible to all members of this organization. enum: ["secret","closed"]
body.notification_setting string Optional The notification setting the team has chosen. Editing teams without specifying this parameter leaves notification_setting intact. The options are: * notifications_enabled - team members receive notifications when the team is @mentioned. * notifications_disabled - no one receives notifications. enum: ["notifications_enabled","notifications_disabled"]
body.permission string Optional Closing down notice. The permission that new repositories will be added to the team with when none is specified. enum: ["pull","push","admin"]; default: "pull"
body.parent_team_id integer | null Optional The ID of a team to set as the parent team.
body.parent_team_slug string | null Optional The slug of a team to set as the parent team. Ignored when parent_team_id is also provided.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "team_slug": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a team — github.teams.delete-in-org

Run Delete a team with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.team_slug string Required The slug of the team name.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "team_slug": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List pending team invitations — github.teams.list-pending-invitations-in-org

Run List pending team invitations with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.team_slug string Required The slug of the team name.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "team_slug": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List team members — github.teams.list-members-in-org

Run List team members with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.team_slug string Required The slug of the team name.
query object Optional additionalProperties: false
query.role string Optional Filters members returned by their role in the team. enum: ["member","maintainer","all"]; default: "all"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "team_slug": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get team membership for a user — github.teams.get-membership-for-user-in-org

Run Get team membership for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.team_slug string Required The slug of the team name.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "team_slug": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add or update team membership for a user — github.teams.add-or-update-membership-for-user-in-org

Run Add or update team membership for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.team_slug string Required The slug of the team name.
path.username string Required The handle for the GitHub user account.
body object Optional
body.role string Optional The role that this user should have in the team. enum: ["member","maintainer"]; default: "member"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "team_slug": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove team membership for a user — github.teams.remove-membership-for-user-in-org

Run Remove team membership for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.team_slug string Required The slug of the team name.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "team_slug": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List team repositories — github.teams.list-repos-in-org

Run List team repositories with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.team_slug string Required The slug of the team name.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "team_slug": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check team permissions for a repository — github.teams.check-permissions-for-repo-in-org

Run Check team permissions for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.team_slug string Required The slug of the team name.
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "team_slug": "example",
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add or update team repository permissions — github.teams.add-or-update-repo-permissions-in-org

Run Add or update team repository permissions with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.team_slug string Required The slug of the team name.
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Optional
body.permission string Optional The permission to grant the team on this repository. We accept the following permissions to be set: pull, triage, push, maintain, admin and you can also specify a custom repository role name, if the owning organization has defined any. If no permission is specified, the team's permission attribute will be used to determine what permission to grant the team on this repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "team_slug": "example",
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove a repository from a team — github.teams.remove-repo-in-org

Run Remove a repository from a team with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.team_slug string Required The slug of the team name.
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "team_slug": "example",
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List child teams — github.teams.list-child-in-org

Run List child teams with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
path.team_slug string Required The slug of the team name.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example",
    "team_slug": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get rate limit status for the authenticated user — github.rate-limit.get

Run Get rate limit status for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository — github.repos.get

Run Get a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a repository — github.repos.update

Run Update a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Optional
body.name string Optional The name of the repository.
body.description string Optional A short description of the repository.
body.homepage string Optional A URL with more information about the repository.
body.private boolean Optional Either true to make the repository private or false to make it public. Default: false. Note: You will get a 422 error if the organization restricts changing repository visibility to organization owners and a non-owner tries to change the value of private. default: false
body.visibility string Optional The visibility of the repository. enum: ["public","private"]
body.security_and_analysis object | null Optional Specify which security and analysis features to enable or disable for the repository. To use this parameter, you must have admin permissions for the repository or be an owner or security manager for the organization that owns the repository. For more information, see "Managing security managers in your organization." For example, to enable GitHub Advanced Security, use this data in the body of the PATCH request: { "security_and_analysis": {"advanced_security": { "status": "enabled" } } }. You can check which security and analysis features are currently enabled by using a GET /repos/{owner}/{repo} request.
body.security_and_analysis.advanced_security object Optional Use the status property to enable or disable GitHub Advanced Security for this repository. For more information, see "About GitHub Advanced Security." For standalone Code Scanning or Secret Protection products, this parameter cannot be used.
body.security_and_analysis.advanced_security.status string Optional Can be enabled or disabled.
body.security_and_analysis.code_security object Optional Use the status property to enable or disable GitHub Code Security for this repository.
body.security_and_analysis.code_security.status string Optional Can be enabled or disabled.
body.security_and_analysis.secret_scanning object Optional Use the status property to enable or disable secret scanning for this repository. For more information, see "About secret scanning."
body.security_and_analysis.secret_scanning.status string Optional Can be enabled or disabled.
body.security_and_analysis.secret_scanning_push_protection object Optional Use the status property to enable or disable secret scanning push protection for this repository. For more information, see "Protecting pushes with secret scanning."
body.security_and_analysis.secret_scanning_push_protection.status string Optional Can be enabled or disabled.
body.security_and_analysis.secret_scanning_ai_detection object Optional Use the status property to enable or disable secret scanning AI detection for this repository. For more information, see "Responsible detection of generic secrets with AI."
body.security_and_analysis.secret_scanning_ai_detection.status string Optional Can be enabled or disabled.
body.security_and_analysis.secret_scanning_non_provider_patterns object Optional Use the status property to enable or disable secret scanning non-provider patterns for this repository. For more information, see "Supported secret scanning patterns."
body.security_and_analysis.secret_scanning_non_provider_patterns.status string Optional Can be enabled or disabled.
body.security_and_analysis.secret_scanning_delegated_alert_dismissal object Optional Use the status property to enable or disable secret scanning delegated alert dismissal for this repository.
body.security_and_analysis.secret_scanning_delegated_alert_dismissal.status string Optional Can be enabled or disabled.
body.security_and_analysis.secret_scanning_delegated_bypass object Optional Use the status property to enable or disable secret scanning delegated bypass for this repository.
body.security_and_analysis.secret_scanning_delegated_bypass.status string Optional Can be enabled or disabled.
body.security_and_analysis.secret_scanning_delegated_bypass_options object Optional Feature options for secret scanning delegated bypass. This object is only honored when security_and_analysis.secret_scanning_delegated_bypass.status is set to enabled. You can send this object in the same request as secret_scanning_delegated_bypass, or update just the options in a separate request.
body.security_and_analysis.secret_scanning_delegated_bypass_options.reviewers array Optional The bypass reviewers for secret scanning delegated bypass. If you omit this field, the existing set of reviewers is unchanged.
body.security_and_analysis.secret_scanning_delegated_bypass_options.reviewers[] object Optional
body.security_and_analysis.secret_scanning_delegated_bypass_options.reviewers[].reviewer_id integer Required The ID of the team or role selected as a bypass reviewer
body.security_and_analysis.secret_scanning_delegated_bypass_options.reviewers[].reviewer_type string Required The type of the bypass reviewer enum: ["TEAM","ROLE"]
body.security_and_analysis.secret_scanning_delegated_bypass_options.reviewers[].mode string Optional The bypass mode for the reviewer enum: ["ALWAYS","EXEMPT"]; default: "ALWAYS"
body.has_issues boolean Optional Either true to enable issues for this repository or false to disable them. default: true
body.has_projects boolean Optional Either true to enable projects for this repository or false to disable them. Note: If you're creating a repository in an organization that has disabled repository projects, the default is false, and if you pass true, the API returns an error. default: true
body.has_wiki boolean Optional Either true to enable the wiki for this repository or false to disable it. default: true
body.has_pull_requests boolean Optional Either true to allow pull requests for this repository or false to prevent pull requests. default: true
body.pull_request_creation_policy string Optional The policy that controls who can create pull requests for this repository: all or collaborators_only. enum: ["all","collaborators_only"]
body.is_template boolean Optional Either true to make this repo available as a template repository or false to prevent it. default: false
body.default_branch string Optional Updates the default branch for this repository.
body.allow_squash_merge boolean Optional Either true to allow squash-merging pull requests, or false to prevent squash-merging. default: true
body.allow_merge_commit boolean Optional Either true to allow merging pull requests with a merge commit, or false to prevent merging pull requests with merge commits. default: true
body.allow_rebase_merge boolean Optional Either true to allow rebase-merging pull requests, or false to prevent rebase-merging. default: true
body.allow_auto_merge boolean Optional Either true to allow auto-merge on pull requests, or false to disallow auto-merge. default: false
body.delete_branch_on_merge boolean Optional Either true to allow automatically deleting head branches when pull requests are merged, or false to prevent automatic deletion. default: false
body.allow_update_branch boolean Optional Either true to always allow a pull request head branch that is behind its base branch to be updated even if it is not required to be up to date before merging, or false otherwise. default: false
body.use_squash_pr_title_as_default boolean Optional Either true to allow squash-merge commits to use pull request title, or false to use commit message. **This property is closing down. Please use squash_merge_commit_title instead. default: false
body.squash_merge_commit_title string Optional Required when using squash_merge_commit_message. The default value for a squash merge commit title: - PR_TITLE - default to the pull request's title. - COMMIT_OR_PR_TITLE - default to the commit's title (if only one commit) or the pull request's title (when more than one commit). enum: ["PR_TITLE","COMMIT_OR_PR_TITLE"]
body.squash_merge_commit_message string Optional The default value for a squash merge commit message: - PR_BODY - default to the pull request's body. - COMMIT_MESSAGES - default to the branch's commit messages. - BLANK - default to a blank commit message. enum: ["PR_BODY","COMMIT_MESSAGES","BLANK"]
body.merge_commit_title string Optional Required when using merge_commit_message. The default value for a merge commit title. - PR_TITLE - default to the pull request's title. - MERGE_MESSAGE - default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name). enum: ["PR_TITLE","MERGE_MESSAGE"]
body.merge_commit_message string Optional The default value for a merge commit message. - PR_TITLE - default to the pull request's title. - PR_BODY - default to the pull request's body. - BLANK - default to a blank commit message. enum: ["PR_BODY","PR_TITLE","BLANK"]
body.archived boolean Optional Whether to archive this repository. false will unarchive a previously archived repository. default: false
body.allow_forking boolean Optional Either true to allow private forks, or false to prevent private forks. default: false
body.web_commit_signoff_required boolean Optional Either true to require contributors to sign off on web-based commits, or false to not require contributors to sign off on web-based commits. default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a repository — github.repos.delete

Run Delete a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List artifacts for a repository — github.actions.list-artifacts-for-repo

Run List artifacts for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.name string Optional The name field of an artifact. When specified, only artifacts with this name will be returned.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an artifact — github.actions.get-artifact

Run Get an artifact with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.artifact_id integer Required The unique identifier of the artifact.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "artifact_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an artifact — github.actions.delete-artifact

Run Delete an artifact with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.artifact_id integer Required The unique identifier of the artifact.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "artifact_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get GitHub Actions cache retention limit for a repository — github.actions.get-actions-cache-retention-limit-for-repository

Run Get GitHub Actions cache retention limit for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set GitHub Actions cache retention limit for a repository — github.actions.set-actions-cache-retention-limit-for-repository

Run Set GitHub Actions cache retention limit for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body — Required $ref: "#/definitions/actions-cache-retention-limit-for-repository"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {}
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get GitHub Actions cache storage limit for a repository — github.actions.get-actions-cache-storage-limit-for-repository

Run Get GitHub Actions cache storage limit for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set GitHub Actions cache storage limit for a repository — github.actions.set-actions-cache-storage-limit-for-repository

Run Set GitHub Actions cache storage limit for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body — Required $ref: "#/definitions/actions-cache-storage-limit-for-repository"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {}
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get GitHub Actions cache usage for a repository — github.actions.get-actions-cache-usage

Run Get GitHub Actions cache usage for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List GitHub Actions caches for a repository — github.actions.get-actions-cache-list

Run List GitHub Actions caches for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.ref string Optional The full Git reference for narrowing down the cache. The ref for a branch should be formatted as refs/heads/<branch name>. To reference a pull request use refs/pull/<number>/merge.
query.key string Optional An explicit key or prefix for identifying the cache
query.sort string Optional The property to sort the results by. created_at means when the cache was created. last_accessed_at means when the cache was last accessed. size_in_bytes is the size of the cache in bytes. enum: ["created_at","last_accessed_at","size_in_bytes"]; default: "last_accessed_at"
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete GitHub Actions caches for a repository (using a cache key) — github.actions.delete-actions-cache-by-key

Run Delete GitHub Actions caches for a repository (using a cache key) with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Required additionalProperties: false
query.key string Required A key for identifying the cache.
query.ref string Optional The full Git reference for narrowing down the cache. The ref for a branch should be formatted as refs/heads/<branch name>. To reference a pull request use refs/pull/<number>/merge.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "query": {
    "key": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a GitHub Actions cache for a repository (using a cache ID) — github.actions.delete-actions-cache-by-id

Run Delete a GitHub Actions cache for a repository (using a cache ID) with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.cache_id integer Required The unique identifier of the GitHub Actions cache.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "cache_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List concurrency groups for a repository — github.actions.list-concurrency-groups-for-repository

Run List concurrency groups for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a concurrency group for a repository — github.actions.get-concurrency-group-for-repository

Run Get a concurrency group for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.concurrency_group_name string Required The name of the concurrency group.
query object Optional additionalProperties: false
query.ahead_of_run integer Optional Filter to items ahead of this workflow run ID in the queue, plus the run itself. Matches workflow-level concurrency and reusable-workflow leases held on behalf of the run. Mutually exclusive with ahead_of_job. minimum: 1
query.ahead_of_job integer Optional Filter to items ahead of this job ID in the queue, plus the job itself. Matches job-level concurrency and reusable-workflow leases on the job's ancestor paths. Mutually exclusive with ahead_of_run. minimum: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "concurrency_group_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a job for a workflow run — github.actions.get-job-for-workflow-run

Run Get a job for a workflow run with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.job_id integer Required The unique identifier of the job.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "job_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Re-run a job from a workflow run — github.actions.re-run-job-for-workflow-run

Run Re-run a job from a workflow run with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.job_id integer Required The unique identifier of the job.
body object | null Optional
body.enable_debug_logging boolean Optional Whether to enable debug logging for the re-run. default: false
body.enable_debugger boolean Optional Whether to enable the debugger for the re-run of this job. default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "job_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the customization template for an OIDC subject claim for a repository — github.actions.get-custom-oidc-sub-claim-for-repo

Run Get the customization template for an OIDC subject claim for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set the customization template for an OIDC subject claim for a repository — github.actions.set-custom-oidc-sub-claim-for-repo

Run Set the customization template for an OIDC subject claim for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required Actions OIDC subject customization for a repository
body.use_default boolean Required Whether to use the default template or not. If true, the include_claim_keys field is ignored.
body.include_claim_keys array Optional Array of unique strings. Each claim key can only contain alphanumeric characters and underscores.
body.include_claim_keys[] string Optional
body.use_immutable_subject boolean Optional Whether to opt in to the immutable OIDC subject claim format for this repository. When true, OIDC tokens will use a stable, repository-ID-based sub claim.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "use_default": false,
    "include_claim_keys": [
      "repo",
      "context"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository organization secrets — github.actions.list-repo-organization-secrets

Run List repository organization secrets with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository organization variables — github.actions.list-repo-organization-variables

Run List repository organization variables with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 30). For more information, see "Using pagination in the REST API." default: 10
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get GitHub Actions permissions for a repository — github.actions.get-github-actions-permissions-repository

Run Get GitHub Actions permissions for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set GitHub Actions permissions for a repository — github.actions.set-github-actions-permissions-repository

Run Set GitHub Actions permissions for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.enabled — Required $ref: "#/definitions/actions-enabled"
body.allowed_actions — Optional $ref: "#/definitions/allowed-actions"
body.sha_pinning_required — Optional $ref: "#/definitions/sha-pinning-required"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "enabled": true,
    "allowed_actions": "selected",
    "sha_pinning_required": true
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the level of access for workflows outside of the repository — github.actions.get-workflow-access-to-repository

Run Get the level of access for workflows outside of the repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set the level of access for workflows outside of the repository — github.actions.set-workflow-access-to-repository

Run Set the level of access for workflows outside of the repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body — Required $ref: "#/definitions/actions-workflow-access-to-repository"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "access_level": "none"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get artifact and log retention settings for a repository — github.actions.get-artifact-and-log-retention-settings-repository

Run Get artifact and log retention settings for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set artifact and log retention settings for a repository — github.actions.set-artifact-and-log-retention-settings-repository

Run Set artifact and log retention settings for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body — Required $ref: "#/definitions/actions-artifact-and-log-retention"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "days": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get fork PR contributor approval permissions for a repository — github.actions.get-fork-pr-contributor-approval-permissions-repository

Run Get fork PR contributor approval permissions for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set fork PR contributor approval permissions for a repository — github.actions.set-fork-pr-contributor-approval-permissions-repository

Run Set fork PR contributor approval permissions for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body — Required $ref: "#/definitions/actions-fork-pr-contributor-approval"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "approval_policy": "first_time_contributors_new_to_github"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get private repo fork PR workflow settings for a repository — github.actions.get-private-repo-fork-pr-workflows-settings-repository

Run Get private repo fork PR workflow settings for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set private repo fork PR workflow settings for a repository — github.actions.set-private-repo-fork-pr-workflows-settings-repository

Run Set private repo fork PR workflow settings for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body — Required $ref: "#/definitions/actions-fork-pr-workflows-private-repos-request"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "run_workflows_from_fork_pull_requests": false
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get allowed actions and reusable workflows for a repository — github.actions.get-allowed-actions-repository

Run Get allowed actions and reusable workflows for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set allowed actions and reusable workflows for a repository — github.actions.set-allowed-actions-repository

Run Set allowed actions and reusable workflows for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body — Optional $ref: "#/definitions/selected-actions"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get default workflow permissions for a repository — github.actions.get-github-actions-default-workflow-permissions-repository

Run Get default workflow permissions for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set default workflow permissions for a repository — github.actions.set-github-actions-default-workflow-permissions-repository

Run Set default workflow permissions for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body — Required $ref: "#/definitions/actions-set-default-workflow-permissions"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {}
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository Actions policies — github.actions.get-repo-actions-policies

Run List repository Actions policies with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.has_parents boolean Optional Include policies configured at higher levels that apply to this repository default: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a repository Actions policy — github.actions.create-repo-actions-policy

Run Create a repository Actions policy with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.name string Required The name of the policy.
body.enforcement — Required $ref: "#/definitions/repository-rule-enforcement"
body.conditions — Optional $ref: "#/definitions/actions-policy-repo-conditions"
body.rules array Optional An array of rules within the policy.
body.rules[] — Optional $ref: "#/definitions/actions-rule"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "name": "Require approved actors",
    "enforcement": "active",
    "rules": [
      {
        "type": "restrict_actions_actors",
        "parameters": {
          "allowed_actors": [
            {
              "id": 1234,
              "type": "Team"
            }
          ]
        }
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository Actions policy — github.actions.get-repo-actions-policy

Run Get a repository Actions policy with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.policy_id integer Required The ID of the policy.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "policy_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a repository Actions policy — github.actions.update-repo-actions-policy

Run Update a repository Actions policy with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.policy_id integer Required The ID of the policy.
body object Required
body.name string Optional The name of the policy.
body.enforcement — Optional $ref: "#/definitions/repository-rule-enforcement"
body.conditions — Optional $ref: "#/definitions/actions-policy-repo-conditions"
body.rules array Optional An array of rules within the policy.
body.rules[] — Optional $ref: "#/definitions/actions-rule"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "policy_id": 1
  },
  "body": {
    "name": "Updated policy name",
    "enforcement": "active"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a repository Actions policy — github.actions.delete-repo-actions-policy

Run Delete a repository Actions policy with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.policy_id integer Required The ID of the policy.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "policy_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List self-hosted runners for a repository — github.actions.list-self-hosted-runners-for-repo

Run List self-hosted runners for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.name string Optional The name of a self-hosted runner.
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get runner version end-of-life schedule for a repository — github.actions.get-runner-version-deprecation-for-repo

Run Get runner version end-of-life schedule for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.version string Required The runner version to look up.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "version": "2.328.0"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List runner applications for a repository — github.actions.list-runner-applications-for-repo

Run List runner applications for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create configuration for a just-in-time runner for a repository — github.actions.generate-runner-jitconfig-for-repo

Run Create configuration for a just-in-time runner for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.name string Required The name of the new runner.
body.runner_group_id integer Required The ID of the runner group to register the runner to.
body.labels array Required The names of the custom labels to add to the runner. Minimum items: 1. Maximum items: 100. minItems: 1; maxItems: 100
body.labels[] string Optional
body.work_folder string Optional The working directory to be used for job execution, relative to the runner install directory. default: "_work"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "name": "New runner",
    "runner_group_id": 1,
    "labels": [
      "self-hosted",
      "X64",
      "macOS",
      "no-gpu"
    ],
    "work_folder": "_work"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a registration token for a repository — github.actions.create-registration-token-for-repo

Run Create a registration token for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a remove token for a repository — github.actions.create-remove-token-for-repo

Run Create a remove token for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a self-hosted runner for a repository — github.actions.get-self-hosted-runner-for-repo

Run Get a self-hosted runner for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.runner_id integer Required Unique identifier of the self-hosted runner.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "runner_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a self-hosted runner from a repository — github.actions.delete-self-hosted-runner-from-repo

Run Delete a self-hosted runner from a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.runner_id integer Required Unique identifier of the self-hosted runner.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "runner_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List labels for a self-hosted runner for a repository — github.actions.list-labels-for-self-hosted-runner-for-repo

Run List labels for a self-hosted runner for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.runner_id integer Required Unique identifier of the self-hosted runner.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "runner_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add custom labels to a self-hosted runner for a repository — github.actions.add-custom-labels-to-self-hosted-runner-for-repo

Run Add custom labels to a self-hosted runner for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.runner_id integer Required Unique identifier of the self-hosted runner.
body object Required
body.labels array Required The names of the custom labels to add to the runner. minItems: 1; maxItems: 100
body.labels[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "runner_id": 1
  },
  "body": {
    "labels": [
      "gpu",
      "accelerated"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set custom labels for a self-hosted runner for a repository — github.actions.set-custom-labels-for-self-hosted-runner-for-repo

Run Set custom labels for a self-hosted runner for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.runner_id integer Required Unique identifier of the self-hosted runner.
body object Required
body.labels array Required The names of the custom labels to set for the runner. You can pass an empty array to remove all custom labels. minItems: 0; maxItems: 100
body.labels[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "runner_id": 1
  },
  "body": {
    "labels": [
      "gpu",
      "accelerated"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove all custom labels from a self-hosted runner for a repository — github.actions.remove-all-custom-labels-from-self-hosted-runner-for-repo

Run Remove all custom labels from a self-hosted runner for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.runner_id integer Required Unique identifier of the self-hosted runner.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "runner_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove a custom label from a self-hosted runner for a repository — github.actions.remove-custom-label-from-self-hosted-runner-for-repo

Run Remove a custom label from a self-hosted runner for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.runner_id integer Required Unique identifier of the self-hosted runner.
path.name string Required The name of a self-hosted runner's custom label.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "runner_id": 1,
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List workflow runs for a repository — github.actions.list-workflow-runs-for-repo

Run List workflow runs for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.actor string Optional Returns someone's workflow runs. Use the login for the user who created the push associated with the check suite or workflow run.
query.branch string Optional Returns workflow runs associated with a branch. Use the name of the branch of the push.
query.event string Optional Returns workflow run triggered by the event you specify. For example, push, pull_request or issue. For more information, see "Events that trigger workflows."
query.status string Optional Returns workflow runs with the check run status or conclusion that you specify. For example, a conclusion can be success or a status can be in_progress. Only GitHub Actions can set a status of waiting, pending, or requested. enum: ["completed","action_required","cancelled","failure","neutral","skipped","stale","success","timed_out","in_progress","queued","requested","waiting","pending"]
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.created string Optional Returns workflow runs created within the given date-time range. For more information on the syntax, see "Understanding the search syntax." format: "date-time"
query.exclude_pull_requests boolean Optional If true pull requests are omitted from the response (empty array). default: false
query.check_suite_id integer Optional Returns workflow runs with the check_suite_id that you specify.
query.head_sha string Optional Only returns workflow runs that are associated with the specified head_sha.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a workflow run — github.actions.get-workflow-run

Run Get a workflow run with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.
query object Optional additionalProperties: false
query.exclude_pull_requests boolean Optional If true pull requests are omitted from the response (empty array). default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a workflow run — github.actions.delete-workflow-run

Run Delete a workflow run with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the review history for a workflow run — github.actions.get-reviews-for-run

Run Get the review history for a workflow run with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Approve a workflow run for a fork pull request — github.actions.approve-workflow-run

Run Approve a workflow run for a fork pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List workflow run artifacts — github.actions.list-workflow-run-artifacts

Run List workflow run artifacts with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.name string Optional The name field of an artifact. When specified, only artifacts with this name will be returned.
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a workflow run attempt — github.actions.get-workflow-run-attempt

Run Get a workflow run attempt with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.
path.attempt_number integer Required The attempt number of the workflow run.
query object Optional additionalProperties: false
query.exclude_pull_requests boolean Optional If true pull requests are omitted from the response (empty array). default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1,
    "attempt_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List jobs for a workflow run attempt — github.actions.list-jobs-for-workflow-run-attempt

Run List jobs for a workflow run attempt with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.
path.attempt_number integer Required The attempt number of the workflow run.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1,
    "attempt_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Cancel a workflow run — github.actions.cancel-workflow-run

Run Cancel a workflow run with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List concurrency groups for a workflow run — github.actions.list-concurrency-groups-for-workflow-run

Run List concurrency groups for a workflow run with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Review custom deployment protection rules for a workflow run — github.actions.review-custom-gates-for-run

Run Review custom deployment protection rules for a workflow run with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.
body — Required
body — Required anyOf[1]; $ref: "#/definitions/review-custom-gates-comment-required"
body — Required anyOf[2]; $ref: "#/definitions/review-custom-gates-state-required"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1
  },
  "body": {
    "environment_name": "prod-eus",
    "state": "approved",
    "comment": "All health checks passed."
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Force cancel a workflow run — github.actions.force-cancel-workflow-run

Run Force cancel a workflow run with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List jobs for a workflow run — github.actions.list-jobs-for-workflow-run

Run List jobs for a workflow run with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.
query object Optional additionalProperties: false
query.filter string Optional Filters jobs by their completed_at timestamp. latest returns jobs from the most recent execution of the workflow run. all returns all jobs for a workflow run, including from old executions of the workflow run. enum: ["latest","all"]; default: "latest"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete workflow run logs — github.actions.delete-workflow-run-logs

Run Delete workflow run logs with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get pending deployments for a workflow run — github.actions.get-pending-deployments-for-run

Run Get pending deployments for a workflow run with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Review pending deployments for a workflow run — github.actions.review-pending-deployments-for-run

Run Review pending deployments for a workflow run with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.
body object Required
body.environment_ids array Required The list of environment ids to approve or reject
body.environment_ids[] integer Optional
body.state string Required Whether to approve or reject deployment to the specified environments. enum: ["approved","rejected"]
body.comment string Required A comment to accompany the deployment review

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1
  },
  "body": {
    "environment_ids": [
      161171787
    ],
    "state": "approved",
    "comment": "Ship it!"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Re-run a workflow — github.actions.re-run-workflow

Run Re-run a workflow with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.
body object | null Optional
body.enable_debug_logging boolean Optional Whether to enable debug logging for the re-run. default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Re-run failed jobs from a workflow run — github.actions.re-run-workflow-failed-jobs

Run Re-run failed jobs from a workflow run with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.
body object | null Optional
body.enable_debug_logging boolean Optional Whether to enable debug logging for the re-run. default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get workflow run usage — github.actions.get-workflow-run-usage

Run Get workflow run usage with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.run_id integer Required The unique identifier of the workflow run.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "run_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository secrets — github.actions.list-repo-secrets

Run List repository secrets with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository public key — github.actions.get-repo-public-key

Run Get a repository public key with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository secret — github.actions.get-repo-secret

Run Get a repository secret with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update a repository secret — github.actions.create-or-update-repo-secret

Run Create or update a repository secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.secret_name string Required The name of the secret.
body object Required
body.encrypted_value string Required Value for your secret, encrypted with LibSodium using the public key retrieved from the Get a repository public key endpoint. pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$"
body.key_id string Required ID of the key you used to encrypt the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "secret_name": "example"
  },
  "body": {
    "encrypted_value": "c2VjcmV0",
    "key_id": "012345678912345678"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a repository secret — github.actions.delete-repo-secret

Run Delete a repository secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository variables — github.actions.list-repo-variables

Run List repository variables with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 30). For more information, see "Using pagination in the REST API." default: 10
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a repository variable — github.actions.create-repo-variable

Run Create a repository variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.name string Required The name of the variable.
body.value string Required The value of the variable.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "name": "USERNAME",
    "value": "octocat"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository variable — github.actions.get-repo-variable

Run Get a repository variable with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.name string Required The name of the variable.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a repository variable — github.actions.update-repo-variable

Run Update a repository variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.name string Required The name of the variable.
body object Required
body.name string Optional The name of the variable.
body.value string Optional The value of the variable.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "name": "example"
  },
  "body": {
    "name": "USERNAME",
    "value": "octocat"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a repository variable — github.actions.delete-repo-variable

Run Delete a repository variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.name string Required The name of the variable.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository workflows — github.actions.list-repo-workflows

Run List repository workflows with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a workflow — github.actions.get-workflow

Run Get a workflow with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.workflow_id — Required The ID of the workflow. You can also pass the workflow file name as a string.
path.workflow_id integer Required oneOf[1]
path.workflow_id string Required oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "workflow_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Disable a workflow — github.actions.disable-workflow

Run Disable a workflow with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.workflow_id — Required The ID of the workflow. You can also pass the workflow file name as a string.
path.workflow_id integer Required oneOf[1]
path.workflow_id string Required oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "workflow_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a workflow dispatch event — github.actions.create-workflow-dispatch

Run Create a workflow dispatch event with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.workflow_id — Required The ID of the workflow. You can also pass the workflow file name as a string.
path.workflow_id integer Required oneOf[1]
path.workflow_id string Required oneOf[2]
body object Required
body.ref string Required The git reference for the workflow. The reference can be a branch or tag name.
body.inputs object Optional Input keys and values configured in the workflow file. The maximum number of properties is 25. Any default properties configured in the workflow file will be used when inputs are omitted. maxProperties: 25; additionalProperties: true
body.return_run_details boolean Optional Whether the response should include the workflow run ID and URLs.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "workflow_id": 1
  },
  "body": {
    "ref": "topic-branch",
    "inputs": {
      "name": "Mona the Octocat",
      "home": "San Francisco, CA"
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Enable a workflow — github.actions.enable-workflow

Run Enable a workflow with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.workflow_id — Required The ID of the workflow. You can also pass the workflow file name as a string.
path.workflow_id integer Required oneOf[1]
path.workflow_id string Required oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "workflow_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List workflow runs for a workflow — github.actions.list-workflow-runs

Run List workflow runs for a workflow with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.workflow_id — Required The ID of the workflow. You can also pass the workflow file name as a string.
path.workflow_id integer Required oneOf[1]
path.workflow_id string Required oneOf[2]
query object Optional additionalProperties: false
query.actor string Optional Returns someone's workflow runs. Use the login for the user who created the push associated with the check suite or workflow run.
query.branch string Optional Returns workflow runs associated with a branch. Use the name of the branch of the push.
query.event string Optional Returns workflow run triggered by the event you specify. For example, push, pull_request or issue. For more information, see "Events that trigger workflows."
query.status string Optional Returns workflow runs with the check run status or conclusion that you specify. For example, a conclusion can be success or a status can be in_progress. Only GitHub Actions can set a status of waiting, pending, or requested. enum: ["completed","action_required","cancelled","failure","neutral","skipped","stale","success","timed_out","in_progress","queued","requested","waiting","pending"]
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.created string Optional Returns workflow runs created within the given date-time range. For more information on the syntax, see "Understanding the search syntax." format: "date-time"
query.exclude_pull_requests boolean Optional If true pull requests are omitted from the response (empty array). default: false
query.check_suite_id integer Optional Returns workflow runs with the check_suite_id that you specify.
query.head_sha string Optional Only returns workflow runs that are associated with the specified head_sha.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "workflow_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get workflow usage — github.actions.get-workflow-usage

Run Get workflow usage with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.workflow_id — Required The ID of the workflow. You can also pass the workflow file name as a string.
path.workflow_id integer Required oneOf[1]
path.workflow_id string Required oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "workflow_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository activities — github.repos.list-activities

Run List repository activities with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.ref string Optional The Git reference for the activities you want to list. The ref for a branch can be formatted either as refs/heads/BRANCH_NAME or BRANCH_NAME, where BRANCH_NAME is the name of your branch.
query.actor string Optional The GitHub username to use to filter by the actor who performed the activity.
query.time_period string Optional The time period to filter by. For example, day will filter for activity that occurred in the past 24 hours, and week will filter for activity that occurred in the past 7 days (168 hours). enum: ["day","week","month","quarter","year"]
query.activity_type string Optional The activity type to filter by. For example, you can choose to filter by "force_push", to see all force pushes to the repository. enum: ["push","force_push","branch_creation","branch_deletion","pr_merge","merge_queue_merge"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository organization secrets — github.agents.list-repo-organization-secrets

Run List repository organization secrets with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository organization variables — github.agents.list-repo-organization-variables

Run List repository organization variables with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 30). For more information, see "Using pagination in the REST API." default: 10
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository secrets — github.agents.list-repo-secrets

Run List repository secrets with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository public key — github.agents.get-repo-public-key

Run Get a repository public key with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository secret — github.agents.get-repo-secret

Run Get a repository secret with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update a repository secret — github.agents.create-or-update-repo-secret

Run Create or update a repository secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.secret_name string Required The name of the secret.
body object Required
body.encrypted_value string Required Value for your secret, encrypted with LibSodium using the public key retrieved from the Get a repository public key endpoint. pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$"
body.key_id string Required ID of the key you used to encrypt the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "secret_name": "example"
  },
  "body": {
    "encrypted_value": "c2VjcmV0",
    "key_id": "012345678912345678"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a repository secret — github.agents.delete-repo-secret

Run Delete a repository secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository variables — github.agents.list-repo-variables

Run List repository variables with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 30). For more information, see "Using pagination in the REST API." default: 10
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a repository variable — github.agents.create-repo-variable

Run Create a repository variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.name string Required The name of the variable.
body.value string Required The value of the variable.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "name": "USERNAME",
    "value": "octocat"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository variable — github.agents.get-repo-variable

Run Get a repository variable with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.name string Required The name of the variable.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a repository variable — github.agents.update-repo-variable

Run Update a repository variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.name string Required The name of the variable.
body object Required
body.name string Optional The name of the variable.
body.value string Optional The value of the variable.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "name": "example"
  },
  "body": {
    "name": "USERNAME",
    "value": "octocat"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a repository variable — github.agents.delete-repo-variable

Run Delete a repository variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.name string Required The name of the variable.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List assignees — github.issues.list-assignees

Run List assignees with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check if a user can be assigned — github.issues.check-user-can-be-assigned

Run Check if a user can be assigned with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.assignee string Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "assignee": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an attestation — github.repos.create-attestation

Run Create an attestation with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.bundle object Required The attestation's Sigstore Bundle. Refer to the Sigstore Bundle Specification for more information.
body.bundle.mediaType string Optional
body.bundle.verificationMaterial object Optional additionalProperties: true
body.bundle.dsseEnvelope object Optional additionalProperties: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "bundle": {}
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List attestations — github.repos.list-attestations

Run List attestations with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.subject_digest string Required The parameter should be set to the attestation's subject's SHA256 digest, in the form sha256:HEX_DIGEST.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.predicate_type string Optional Optional filter for fetching attestations with a given predicate type. This option accepts provenance, sbom, release, or freeform text for custom predicate types.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "subject_digest": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check if Dependabot security updates are enabled for a repository — github.repos.check-automated-security-fixes

Run Check if Dependabot security updates are enabled for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Enable Dependabot security updates — github.repos.enable-automated-security-fixes

Run Enable Dependabot security updates with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Disable Dependabot security updates — github.repos.disable-automated-security-fixes

Run Disable Dependabot security updates with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List branches — github.repos.list-branches

Run List branches with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.protected boolean Optional Setting to true returns only branches protected by branch protections or rulesets. When set to false, only unprotected branches are returned. Omitting this parameter returns all branches.
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a branch — github.repos.get-branch

Run Get a branch with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get branch protection — github.repos.get-branch-protection

Run Get branch protection with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update branch protection — github.repos.update-branch-protection

Run Update branch protection with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.
body object Required
body.required_status_checks object | null Required Require status checks to pass before merging. Set to null to disable.
body.required_status_checks.strict boolean Required Require branches to be up to date before merging.
body.required_status_checks.contexts array Required Closing down notice: The list of status checks to require in order to merge into this branch. If any of these checks have recently been set by a particular GitHub App, they will be required to come from that app in future for the branch to merge. Use checks instead of contexts for more fine-grained control.
body.required_status_checks.contexts[] string Optional
body.required_status_checks.checks array Optional The list of status checks to require in order to merge into this branch.
body.required_status_checks.checks[] object Optional
body.required_status_checks.checks[].context string Required The name of the required check
body.required_status_checks.checks[].app_id integer Optional The ID of the GitHub App that must provide this check. Omit this field to automatically select the GitHub App that has recently provided this check, or any app if it was not set by a GitHub App. Pass -1 to explicitly allow any app to set the status.
body.enforce_admins boolean | null Required Enforce all configured restrictions for administrators. Set to true to enforce required status checks for repository administrators. Set to null to disable.
body.required_pull_request_reviews object | null Required Require at least one approving review on a pull request, before merging. Set to null to disable.
body.required_pull_request_reviews.dismissal_restrictions object Optional Specify which users, teams, and apps can dismiss pull request reviews. Pass an empty dismissal_restrictions object to disable. User and team dismissal_restrictions are only available for organization-owned repositories. Omit this parameter for personal repositories.
body.required_pull_request_reviews.dismissal_restrictions.users array Optional The list of user logins with dismissal access
body.required_pull_request_reviews.dismissal_restrictions.users[] string Optional
body.required_pull_request_reviews.dismissal_restrictions.teams array Optional The list of team slugs with dismissal access
body.required_pull_request_reviews.dismissal_restrictions.teams[] string Optional
body.required_pull_request_reviews.dismissal_restrictions.apps array Optional The list of app slugs with dismissal access
body.required_pull_request_reviews.dismissal_restrictions.apps[] string Optional
body.required_pull_request_reviews.dismiss_stale_reviews boolean Optional Set to true if you want to automatically dismiss approving reviews when someone pushes a new commit.
body.required_pull_request_reviews.require_code_owner_reviews boolean Optional Blocks merging pull requests until code owners review them.
body.required_pull_request_reviews.required_approving_review_count integer Optional Specify the number of reviewers required to approve pull requests. Use a number between 1 and 6 or 0 to not require reviewers.
body.required_pull_request_reviews.require_last_push_approval boolean Optional Whether the most recent push must be approved by someone other than the person who pushed it. Default: false. default: false
body.required_pull_request_reviews.bypass_pull_request_allowances object Optional Allow specific users, teams, or apps to bypass pull request requirements.
body.required_pull_request_reviews.bypass_pull_request_allowances.users array Optional The list of user logins allowed to bypass pull request requirements.
body.required_pull_request_reviews.bypass_pull_request_allowances.users[] string Optional
body.required_pull_request_reviews.bypass_pull_request_allowances.teams array Optional The list of team slugs allowed to bypass pull request requirements.
body.required_pull_request_reviews.bypass_pull_request_allowances.teams[] string Optional
body.required_pull_request_reviews.bypass_pull_request_allowances.apps array Optional The list of app slugs allowed to bypass pull request requirements.
body.required_pull_request_reviews.bypass_pull_request_allowances.apps[] string Optional
body.restrictions object | null Required Restrict who can push to the protected branch. User, app, and team restrictions are only available for organization-owned repositories. Set to null to disable.
body.restrictions.users array Required The list of user logins with push access
body.restrictions.users[] string Optional
body.restrictions.teams array Required The list of team slugs with push access
body.restrictions.teams[] string Optional
body.restrictions.apps array Optional The list of app slugs with push access
body.restrictions.apps[] string Optional
body.required_linear_history boolean Optional Enforces a linear commit Git history, which prevents anyone from pushing merge commits to a branch. Set to true to enforce a linear commit history. Set to false to disable a linear commit Git history. Your repository must allow squash merging or rebase merging before you can enable a linear commit history. Default: false. For more information, see "Requiring a linear commit history" in the GitHub Help documentation.
body.allow_force_pushes boolean | null Optional Permits force pushes to the protected branch by anyone with write access to the repository. Set to true to allow force pushes. Set to false or null to block force pushes. Default: false. For more information, see "Enabling force pushes to a protected branch" in the GitHub Help documentation."
body.allow_deletions boolean Optional Allows deletion of the protected branch by anyone with write access to the repository. Set to false to prevent deletion of the protected branch. Default: false. For more information, see "Enabling force pushes to a protected branch" in the GitHub Help documentation.
body.block_creations boolean Optional If set to true, the restrictions branch protection settings which limits who can push will also block pushes which create new branches, unless the push is initiated by a user, team, or app which has the ability to push. Set to true to restrict new branch creation. Default: false.
body.required_conversation_resolution boolean Optional Requires all conversations on code to be resolved before a pull request can be merged into a branch that matches this rule. Set to false to disable. Default: false.
body.lock_branch boolean Optional Whether to set the branch as read-only. If this is true, users will not be able to push to the branch. Default: false. default: false
body.allow_fork_syncing boolean Optional Whether users can pull changes from upstream when the branch is locked. Set to true to allow fork syncing. Set to false to prevent fork syncing. Default: false. default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  },
  "body": {
    "required_status_checks": {
      "strict": true,
      "contexts": [
        "continuous-integration/travis-ci"
      ]
    },
    "enforce_admins": true,
    "required_pull_request_reviews": {
      "dismissal_restrictions": {
        "users": [
          "octocat"
        ],
        "teams": [
          "justice-league"
        ]
      },
      "dismiss_stale_reviews": true,
      "require_code_owner_reviews": true,
      "required_approving_review_count": 2,
      "require_last_push_approval": true,
      "bypass_pull_request_allowances": {
        "users": [
          "octocat"
        ],
        "teams": [
          "justice-league"
        ]
      }
    },
    "restrictions": {
      "users": [
        "octocat"
      ],
      "teams": [
        "justice-league"
      ],
      "apps": [
        "super-ci"
      ]
    },
    "required_linear_history": true,
    "allow_force_pushes": true,
    "allow_deletions": true,
    "block_creations": true,
    "required_conversation_resolution": true,
    "lock_branch": true,
    "allow_fork_syncing": true
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete branch protection — github.repos.delete-branch-protection

Run Delete branch protection with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get admin branch protection — github.repos.get-admin-branch-protection

Run Get admin branch protection with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set admin branch protection — github.repos.set-admin-branch-protection

Run Set admin branch protection with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete admin branch protection — github.repos.delete-admin-branch-protection

Run Delete admin branch protection with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get pull request review protection — github.repos.get-pull-request-review-protection

Run Get pull request review protection with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update pull request review protection — github.repos.update-pull-request-review-protection

Run Update pull request review protection with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.
body object Optional
body.dismissal_restrictions object Optional Specify which users, teams, and apps can dismiss pull request reviews. Pass an empty dismissal_restrictions object to disable. User and team dismissal_restrictions are only available for organization-owned repositories. Omit this parameter for personal repositories.
body.dismissal_restrictions.users array Optional The list of user logins with dismissal access
body.dismissal_restrictions.users[] string Optional
body.dismissal_restrictions.teams array Optional The list of team slugs with dismissal access
body.dismissal_restrictions.teams[] string Optional
body.dismissal_restrictions.apps array Optional The list of app slugs with dismissal access
body.dismissal_restrictions.apps[] string Optional
body.dismiss_stale_reviews boolean Optional Set to true if you want to automatically dismiss approving reviews when someone pushes a new commit.
body.require_code_owner_reviews boolean Optional Blocks merging pull requests until code owners have reviewed.
body.required_approving_review_count integer Optional Specifies the number of reviewers required to approve pull requests. Use a number between 1 and 6 or 0 to not require reviewers.
body.require_last_push_approval boolean Optional Whether the most recent push must be approved by someone other than the person who pushed it. Default: false default: false
body.bypass_pull_request_allowances object Optional Allow specific users, teams, or apps to bypass pull request requirements.
body.bypass_pull_request_allowances.users array Optional The list of user logins allowed to bypass pull request requirements.
body.bypass_pull_request_allowances.users[] string Optional
body.bypass_pull_request_allowances.teams array Optional The list of team slugs allowed to bypass pull request requirements.
body.bypass_pull_request_allowances.teams[] string Optional
body.bypass_pull_request_allowances.apps array Optional The list of app slugs allowed to bypass pull request requirements.
body.bypass_pull_request_allowances.apps[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete pull request review protection — github.repos.delete-pull-request-review-protection

Run Delete pull request review protection with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get commit signature protection — github.repos.get-commit-signature-protection

Run Get commit signature protection with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create commit signature protection — github.repos.create-commit-signature-protection

Run Create commit signature protection with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete commit signature protection — github.repos.delete-commit-signature-protection

Run Delete commit signature protection with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get status checks protection — github.repos.get-status-checks-protection

Run Get status checks protection with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update status check protection — github.repos.update-status-check-protection

Run Update status check protection with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.
body object Optional
body.strict boolean Optional Require branches to be up to date before merging.
body.contexts array Optional Closing down notice: The list of status checks to require in order to merge into this branch. If any of these checks have recently been set by a particular GitHub App, they will be required to come from that app in future for the branch to merge. Use checks instead of contexts for more fine-grained control.
body.contexts[] string Optional
body.checks array Optional The list of status checks to require in order to merge into this branch.
body.checks[] object Optional
body.checks[].context string Required The name of the required check
body.checks[].app_id integer Optional The ID of the GitHub App that must provide this check. Omit this field to automatically select the GitHub App that has recently provided this check, or any app if it was not set by a GitHub App. Pass -1 to explicitly allow any app to set the status.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove status check protection — github.repos.remove-status-check-protection

Run Remove status check protection with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get all status check contexts — github.repos.get-all-status-check-contexts

Run Get all status check contexts with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add status check contexts — github.repos.add-status-check-contexts

Run Add status check contexts with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.
body — Optional
body object Optional oneOf[1]
body.contexts array Required The name of the status checks oneOf[1]
body.contexts[] string Optional oneOf[1]
body array Optional The name of the status checks oneOf[2]
body[] string Optional oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set status check contexts — github.repos.set-status-check-contexts

Run Set status check contexts with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.
body — Optional
body object Optional oneOf[1]
body.contexts array Required The name of the status checks oneOf[1]
body.contexts[] string Optional oneOf[1]
body array Optional The name of the status checks oneOf[2]
body[] string Optional oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove status check contexts — github.repos.remove-status-check-contexts

Run Remove status check contexts with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.
body — Optional
body object Optional oneOf[1]
body.contexts array Required The name of the status checks oneOf[1]
body.contexts[] string Optional oneOf[1]
body array Optional The name of the status checks oneOf[2]
body[] string Optional oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get access restrictions — github.repos.get-access-restrictions

Run Get access restrictions with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete access restrictions — github.repos.delete-access-restrictions

Run Delete access restrictions with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get apps with access to the protected branch — github.repos.get-apps-with-access-to-protected-branch

Run Get apps with access to the protected branch with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add app access restrictions — github.repos.add-app-access-restrictions

Run Add app access restrictions with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.
body object Required
body.apps array Required The GitHub Apps that have push access to this branch. Use the slugified version of the app name. Note: The list of users, apps, and teams in total is limited to 100 items.
body.apps[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  },
  "body": {
    "apps": [
      "octoapp"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set app access restrictions — github.repos.set-app-access-restrictions

Run Set app access restrictions with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.
body object Required
body.apps array Required The GitHub Apps that have push access to this branch. Use the slugified version of the app name. Note: The list of users, apps, and teams in total is limited to 100 items.
body.apps[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  },
  "body": {
    "apps": [
      "octoapp"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove app access restrictions — github.repos.remove-app-access-restrictions

Run Remove app access restrictions with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.
body object Required
body.apps array Required The GitHub Apps that have push access to this branch. Use the slugified version of the app name. Note: The list of users, apps, and teams in total is limited to 100 items.
body.apps[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  },
  "body": {
    "apps": [
      "my-app"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get teams with access to the protected branch — github.repos.get-teams-with-access-to-protected-branch

Run Get teams with access to the protected branch with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add team access restrictions — github.repos.add-team-access-restrictions

Run Add team access restrictions with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.
body — Optional
body object Optional oneOf[1]
body.teams array Required The slug values for teams oneOf[1]
body.teams[] string Optional oneOf[1]
body array Optional The slug values for teams oneOf[2]
body[] string Optional oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set team access restrictions — github.repos.set-team-access-restrictions

Run Set team access restrictions with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.
body — Optional
body object Optional oneOf[1]
body.teams array Required The slug values for teams oneOf[1]
body.teams[] string Optional oneOf[1]
body array Optional The slug values for teams oneOf[2]
body[] string Optional oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove team access restrictions — github.repos.remove-team-access-restrictions

Run Remove team access restrictions with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.
body — Optional
body object Optional oneOf[1]
body.teams array Required The slug values for teams oneOf[1]
body.teams[] string Optional oneOf[1]
body array Optional The slug values for teams oneOf[2]
body[] string Optional oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get users with access to the protected branch — github.repos.get-users-with-access-to-protected-branch

Run Get users with access to the protected branch with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add user access restrictions — github.repos.add-user-access-restrictions

Run Add user access restrictions with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.
body object Required
body.users array Required The username for users
body.users[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  },
  "body": {
    "users": [
      "octocat"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set user access restrictions — github.repos.set-user-access-restrictions

Run Set user access restrictions with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.
body object Required
body.users array Required The username for users
body.users[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  },
  "body": {
    "users": [
      "octocat"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove user access restrictions — github.repos.remove-user-access-restrictions

Run Remove user access restrictions with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.
body object Required
body.users array Required The username for users
body.users[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  },
  "body": {
    "users": [
      "octocat"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Rename a branch — github.repos.rename-branch

Run Rename a branch with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.
body object Required
body.new_name string Required The new name of the branch.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  },
  "body": {
    "new_name": "my_renamed_branch"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a check run — github.checks.create

Run Create a check run with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.name string Required The name of the check. For example, "code-coverage".
body.head_sha string Required The SHA of the commit.
body.details_url string Optional The URL of the integrator's site that has the full details of the check. If the integrator does not provide this, then the homepage of the GitHub app is used.
body.external_id string Optional A reference for the run on the integrator's system.
body.status string Optional The current status of the check run. Only GitHub Actions can set a status of waiting, pending, or requested. enum: ["queued","in_progress","completed","waiting","requested","pending"]; default: "queued"
body.started_at string Optional The time that the check run began. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
body.conclusion string Optional Required if you provide completed_at or a status of completed. The final conclusion of the check. Note: Providing conclusion will automatically set the status parameter to completed. You cannot change a check run conclusion to stale, only GitHub can set this. enum: ["action_required","cancelled","failure","neutral","success","skipped","stale","timed_out"]
body.completed_at string Optional The time the check completed. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
body.output object Optional Check runs can accept a variety of data in the output object, including a title and summary and can optionally provide descriptive details about the run.
body.output.title string Required The title of the check run.
body.output.summary string Required The summary of the check run. This parameter supports Markdown. Maximum length: 65535 characters. maxLength: 65535
body.output.text string Optional The details of the check run. This parameter supports Markdown. Maximum length: 65535 characters. maxLength: 65535
body.output.annotations array Optional Adds information from your analysis to specific lines of code. Annotations are visible on GitHub in the Checks and Files changed tab of the pull request. The Checks API limits the number of annotations to a maximum of 50 per API request. To create more than 50 annotations, you have to make multiple requests to the Update a check run endpoint. Each time you update the check run, annotations are appended to the list of annotations that already exist for the check run. GitHub Actions are limited to 10 warning annotations and 10 error annotations per step. For details about how you can view annotations on GitHub, see "About status checks". maxItems: 50
body.output.annotations[] object Optional
body.output.annotations[].path string Required The path of the file to add an annotation to. For example, assets/css/main.css.
body.output.annotations[].start_line integer Required The start line of the annotation. Line numbers start at 1.
body.output.annotations[].end_line integer Required The end line of the annotation.
body.output.annotations[].start_column integer Optional The start column of the annotation. Annotations only support start_column and end_column on the same line. Omit this parameter if start_line and end_line have different values. Column numbers start at 1.
body.output.annotations[].end_column integer Optional The end column of the annotation. Annotations only support start_column and end_column on the same line. Omit this parameter if start_line and end_line have different values.
body.output.annotations[].annotation_level string Required The level of the annotation. enum: ["notice","warning","failure"]
body.output.annotations[].message string Required A short description of the feedback for these lines of code. The maximum size is 64 KB.
body.output.annotations[].title string Optional The title that represents the annotation. The maximum size is 255 characters.
body.output.annotations[].raw_details string Optional Details about this annotation. The maximum size is 64 KB.
body.output.images array Optional Adds images to the output displayed in the GitHub pull request UI.
body.output.images[] object Optional
body.output.images[].alt string Required The alternative text for the image.
body.output.images[].image_url string Required The full URL of the image.
body.output.images[].caption string Optional A short image description.
body.actions array Optional Displays a button on GitHub that can be clicked to alert your app to do additional tasks. For example, a code linting app can display a button that automatically fixes detected errors. The button created in this object is displayed after the check run completes. When a user clicks the button, GitHub sends the check_run.requested_action webhook to your app. Each action includes a label, identifier and description. A maximum of three actions are accepted. To learn more about check runs and requested actions, see "Check runs and requested actions." maxItems: 3
body.actions[] object Optional
body.actions[].label string Required The text to be displayed on a button in the web UI. The maximum size is 20 characters. maxLength: 20
body.actions[].description string Required A short explanation of what this action would do. The maximum size is 40 characters. maxLength: 40
body.actions[].identifier string Required A reference for the action on the integrator's system. The maximum size is 20 characters. maxLength: 20
body object Required oneOf[1]; additionalProperties: true
body.status — Required oneOf[1]; enum: ["completed"]
body object Required oneOf[2]; additionalProperties: true
body.status — Optional oneOf[2]; enum: ["queued","in_progress"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "name": "mighty_readme",
    "head_sha": "ce587453ced02b1526dfb4cb910479d431683101",
    "status": "in_progress",
    "external_id": "42",
    "started_at": "2018-05-04T01:14:52Z",
    "output": {
      "title": "Mighty Readme report",
      "summary": "",
      "text": ""
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a check run — github.checks.get

Run Get a check run with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.check_run_id integer Required The unique identifier of the check run.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "check_run_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a check run — github.checks.update

Run Update a check run with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.check_run_id integer Required The unique identifier of the check run.
body object Required
body.name string Optional The name of the check. For example, "code-coverage".
body.details_url string Optional The URL of the integrator's site that has the full details of the check.
body.external_id string Optional A reference for the run on the integrator's system.
body.started_at string Optional This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
body.status string Optional The current status of the check run. Only GitHub Actions can set a status of waiting, pending, or requested. enum: ["queued","in_progress","completed","waiting","requested","pending"]
body.conclusion string Optional Required if you provide completed_at or a status of completed. The final conclusion of the check. Note: Providing conclusion will automatically set the status parameter to completed. You cannot change a check run conclusion to stale, only GitHub can set this. enum: ["action_required","cancelled","failure","neutral","success","skipped","stale","timed_out"]
body.completed_at string Optional The time the check completed. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
body.output object Optional Check runs can accept a variety of data in the output object, including a title and summary and can optionally provide descriptive details about the run.
body.output.title string Optional Required.
body.output.summary string Required Can contain Markdown. maxLength: 65535
body.output.text string Optional Can contain Markdown. maxLength: 65535
body.output.annotations array Optional Adds information from your analysis to specific lines of code. Annotations are visible in GitHub's pull request UI. Annotations are visible in GitHub's pull request UI. The Checks API limits the number of annotations to a maximum of 50 per API request. To create more than 50 annotations, you have to make multiple requests to the Update a check run endpoint. Each time you update the check run, annotations are appended to the list of annotations that already exist for the check run. GitHub Actions are limited to 10 warning annotations and 10 error annotations per step. For details about annotations in the UI, see "About status checks". maxItems: 50
body.output.annotations[] object Optional
body.output.annotations[].path string Required The path of the file to add an annotation to. For example, assets/css/main.css.
body.output.annotations[].start_line integer Required The start line of the annotation. Line numbers start at 1.
body.output.annotations[].end_line integer Required The end line of the annotation.
body.output.annotations[].start_column integer Optional The start column of the annotation. Annotations only support start_column and end_column on the same line. Omit this parameter if start_line and end_line have different values. Column numbers start at 1.
body.output.annotations[].end_column integer Optional The end column of the annotation. Annotations only support start_column and end_column on the same line. Omit this parameter if start_line and end_line have different values.
body.output.annotations[].annotation_level string Required The level of the annotation. enum: ["notice","warning","failure"]
body.output.annotations[].message string Required A short description of the feedback for these lines of code. The maximum size is 64 KB.
body.output.annotations[].title string Optional The title that represents the annotation. The maximum size is 255 characters.
body.output.annotations[].raw_details string Optional Details about this annotation. The maximum size is 64 KB.
body.output.images array Optional Adds images to the output displayed in the GitHub pull request UI.
body.output.images[] object Optional
body.output.images[].alt string Required The alternative text for the image.
body.output.images[].image_url string Required The full URL of the image.
body.output.images[].caption string Optional A short image description.
body.actions array Optional Possible further actions the integrator can perform, which a user may trigger. Each action includes a label, identifier and description. A maximum of three actions are accepted. To learn more about check runs and requested actions, see "Check runs and requested actions." maxItems: 3
body.actions[] object Optional
body.actions[].label string Required The text to be displayed on a button in the web UI. The maximum size is 20 characters. maxLength: 20
body.actions[].description string Required A short explanation of what this action would do. The maximum size is 40 characters. maxLength: 40
body.actions[].identifier string Required A reference for the action on the integrator's system. The maximum size is 20 characters. maxLength: 20
body object Required anyOf[1]; additionalProperties: true
body.status — Optional anyOf[1]; enum: ["completed"]
body object Required anyOf[2]; additionalProperties: true
body.status — Optional anyOf[2]; enum: ["queued","in_progress"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "check_run_id": 1
  },
  "body": {
    "name": "mighty_readme",
    "started_at": "2018-05-04T01:14:52Z",
    "status": "completed",
    "conclusion": "success",
    "completed_at": "2018-05-04T01:14:52Z",
    "output": {
      "title": "Mighty Readme report",
      "summary": "There are 0 failures, 2 warnings, and 1 notices.",
      "text": "You may have some misspelled words on lines 2 and 4. You also may want to add a section in your README about how to install your app.",
      "annotations": [
        {
          "path": "README.md",
          "annotation_level": "warning",
          "title": "Spell Checker",
          "message": "Check your spelling for 'banaas'.",
          "raw_details": "Do you mean 'bananas' or 'banana'?",
          "start_line": 2,
          "end_line": 2
        },
        {
          "path": "README.md",
          "annotation_level": "warning",
          "title": "Spell Checker",
          "message": "Check your spelling for 'aples'",
          "raw_details": "Do you mean 'apples' or 'Naples'",
          "start_line": 4,
          "end_line": 4
        }
      ],
      "images": [
        {
          "alt": "Super bananas",
          "image_url": "http://example.com/images/42"
        }
      ]
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List check run annotations — github.checks.list-annotations

Run List check run annotations with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.check_run_id integer Required The unique identifier of the check run.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "check_run_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Rerequest a check run — github.checks.rerequest-run

Run Rerequest a check run with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.check_run_id integer Required The unique identifier of the check run.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "check_run_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a check suite — github.checks.create-suite

Run Create a check suite with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.head_sha string Required The sha of the head commit.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "head_sha": "d6fde92930d4715a2b49857d24b940956b26d2d3"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update repository preferences for check suites — github.checks.set-suites-preferences

Run Update repository preferences for check suites with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.auto_trigger_checks array Optional Enables or disables automatic creation of CheckSuite events upon pushes to the repository. Enabled by default.
body.auto_trigger_checks[] object Optional
body.auto_trigger_checks[].app_id integer Required The id of the GitHub App.
body.auto_trigger_checks[].setting boolean Required Set to true to enable automatic creation of CheckSuite events upon pushes to the repository, or false to disable them. default: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "auto_trigger_checks": [
      {
        "app_id": 4,
        "setting": false
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a check suite — github.checks.get-suite

Run Get a check suite with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.check_suite_id integer Required The unique identifier of the check suite.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "check_suite_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List check runs in a check suite — github.checks.list-for-suite

Run List check runs in a check suite with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.check_suite_id integer Required The unique identifier of the check suite.
query object Optional additionalProperties: false
query.check_name string Optional Returns check runs with the specified name.
query.status string Optional Returns check runs with the specified status. enum: ["queued","in_progress","completed"]
query.filter string Optional Filters check runs by their completed_at timestamp. latest returns the most recent check runs. enum: ["latest","all"]; default: "latest"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "check_suite_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Rerequest a check suite — github.checks.rerequest-suite

Run Rerequest a check suite with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.check_suite_id integer Required The unique identifier of the check suite.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "check_suite_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List code quality findings for a repository — github.code-quality.list-findings-for-repo

Run List code quality findings for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.state string Optional If specified, only code quality findings with this state will be returned. enum: ["open","dismissed"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a code quality finding — github.code-quality.get-finding

Run Get a code quality finding with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.finding_number integer Required The number that identifies a finding.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "finding_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a code quality setup configuration — github.code-quality.get-setup

Run Get a code quality setup configuration with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a code quality setup configuration — github.code-quality.update-setup

Run Update a code quality setup configuration with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body — Required $ref: "#/definitions/code-quality-setup-update"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "state": "configured"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get AI Scan enablement for a repository — github.code-scanning.get-ai-scan-enablement

Run Get AI Scan enablement for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List code scanning alerts for a repository — github.code-scanning.list-alerts-for-repo

Run List code scanning alerts for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.tool_name — Optional The name of a code scanning tool. Only results by this tool will be listed. You can specify the tool by using either tool_name or tool_guid, but not both. $ref: "#/definitions/code-scanning-analysis-tool-name"
query.tool_guid — Optional The GUID of a code scanning tool. Only results by this tool will be listed. Note that some code scanning tools may not include a GUID in their analysis data. You can specify the tool by using either tool_guid or tool_name, but not both. $ref: "#/definitions/code-scanning-analysis-tool-guid"
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.ref — Optional The Git reference for the results you want to list. The ref for a branch can be formatted either as refs/heads/<branch name> or simply <branch name>. To reference a pull request use refs/pull/<number>/merge. $ref: "#/definitions/code-scanning-ref"
query.pr integer Optional The number of the pull request for the results you want to list.
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.sort string Optional The property by which to sort the results. enum: ["created","updated"]; default: "created"
query.state — Optional If specified, only code scanning alerts with this state will be returned. $ref: "#/definitions/code-scanning-alert-state-query"
query.severity — Optional If specified, only code scanning alerts with this severity will be returned. $ref: "#/definitions/code-scanning-alert-severity"
query.assignees string Optional Filter alerts by assignees. Provide a comma-separated list of user handles (e.g., octocat or octocat,hubot). Use * to list alerts with at least one assignee or none to list alerts with no assignees.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a code scanning alert — github.code-scanning.get-alert

Run Get a code scanning alert with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.alert_number — Required The number that identifies an alert. You can find this at the end of the URL for a code scanning alert within GitHub, and in the number field in the response from the GET /repos/{owner}/{repo}/code-scanning/alerts operation. $ref: "#/definitions/alert-number"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "alert_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a code scanning alert — github.code-scanning.update-alert

Run Update a code scanning alert with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.alert_number — Required The number that identifies an alert. You can find this at the end of the URL for a code scanning alert within GitHub, and in the number field in the response from the GET /repos/{owner}/{repo}/code-scanning/alerts operation. $ref: "#/definitions/alert-number"
body object Required
body.state — Optional $ref: "#/definitions/code-scanning-alert-set-state"
body.dismissed_reason — Optional $ref: "#/definitions/code-scanning-alert-dismissed-reason"
body.dismissed_comment — Optional $ref: "#/definitions/code-scanning-alert-dismissed-comment"
body.create_request — Optional $ref: "#/definitions/code-scanning-alert-create-request"
body.assignees — Optional $ref: "#/definitions/code-scanning-alert-assignees"
body — Required anyOf[1]
body — Required anyOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "alert_number": 1
  },
  "body": {
    "state": "dismissed",
    "dismissed_reason": "false positive",
    "dismissed_comment": "This alert is not actually correct, because there's a sanitizer included in the library.",
    "create_request": true
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the status of an autofix for a code scanning alert — github.code-scanning.get-autofix

Run Get the status of an autofix for a code scanning alert with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.alert_number — Required The number that identifies an alert. You can find this at the end of the URL for a code scanning alert within GitHub, and in the number field in the response from the GET /repos/{owner}/{repo}/code-scanning/alerts operation. $ref: "#/definitions/alert-number"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "alert_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an autofix for a code scanning alert — github.code-scanning.create-autofix

Run Create an autofix for a code scanning alert with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.alert_number — Required The number that identifies an alert. You can find this at the end of the URL for a code scanning alert within GitHub, and in the number field in the response from the GET /repos/{owner}/{repo}/code-scanning/alerts operation. $ref: "#/definitions/alert-number"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "alert_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Commit an autofix for a code scanning alert — github.code-scanning.commit-autofix

Run Commit an autofix for a code scanning alert with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.alert_number — Required The number that identifies an alert. You can find this at the end of the URL for a code scanning alert within GitHub, and in the number field in the response from the GET /repos/{owner}/{repo}/code-scanning/alerts operation. $ref: "#/definitions/alert-number"
body — Optional $ref: "#/definitions/code-scanning-autofix-commits"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "alert_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List instances of a code scanning alert — github.code-scanning.list-alert-instances

Run List instances of a code scanning alert with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.alert_number — Required The number that identifies an alert. You can find this at the end of the URL for a code scanning alert within GitHub, and in the number field in the response from the GET /repos/{owner}/{repo}/code-scanning/alerts operation. $ref: "#/definitions/alert-number"
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.ref — Optional The Git reference for the results you want to list. The ref for a branch can be formatted either as refs/heads/<branch name> or simply <branch name>. To reference a pull request use refs/pull/<number>/merge. $ref: "#/definitions/code-scanning-ref"
query.pr integer Optional The number of the pull request for the results you want to list.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "alert_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List code scanning analyses for a repository — github.code-scanning.list-recent-analyses

Run List code scanning analyses for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.tool_name — Optional The name of a code scanning tool. Only results by this tool will be listed. You can specify the tool by using either tool_name or tool_guid, but not both. $ref: "#/definitions/code-scanning-analysis-tool-name"
query.tool_guid — Optional The GUID of a code scanning tool. Only results by this tool will be listed. Note that some code scanning tools may not include a GUID in their analysis data. You can specify the tool by using either tool_guid or tool_name, but not both. $ref: "#/definitions/code-scanning-analysis-tool-guid"
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.pr integer Optional The number of the pull request for the results you want to list.
query.ref — Optional The Git reference for the analyses you want to list. The ref for a branch can be formatted either as refs/heads/<branch name> or simply <branch name>. To reference a pull request use refs/pull/<number>/merge. $ref: "#/definitions/code-scanning-ref"
query.sarif_id — Optional Filter analyses belonging to the same SARIF upload. $ref: "#/definitions/code-scanning-analysis-sarif-id"
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.sort string Optional The property by which to sort the results. enum: ["created"]; default: "created"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a code scanning analysis for a repository — github.code-scanning.get-analysis

Run Get a code scanning analysis for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.analysis_id integer Required The ID of the analysis, as returned from the GET /repos/{owner}/{repo}/code-scanning/analyses operation.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "analysis_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a code scanning analysis from a repository — github.code-scanning.delete-analysis

Run Delete a code scanning analysis from a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.analysis_id integer Required The ID of the analysis, as returned from the GET /repos/{owner}/{repo}/code-scanning/analyses operation.
query object Optional additionalProperties: false
query.confirm_delete string | null Optional Allow deletion if the specified analysis is the last in a set. If you attempt to delete the final analysis in a set without setting this parameter to true, you'll get a 400 response with the message: Analysis is last of its type and deletion may result in the loss of historical alert data. Please specify confirm_delete.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "analysis_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List CodeQL databases for a repository — github.code-scanning.list-codeql-databases

Run List CodeQL databases for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a CodeQL database for a repository — github.code-scanning.get-codeql-database

Run Get a CodeQL database for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.language string Required The language of the CodeQL database.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "language": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a CodeQL database — github.code-scanning.delete-codeql-database

Run Delete a CodeQL database with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.language string Required The language of the CodeQL database.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "language": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a CodeQL variant analysis — github.code-scanning.create-variant-analysis

Run Create a CodeQL variant analysis with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required additionalProperties: false
body.language — Required $ref: "#/definitions/code-scanning-variant-analysis-language"
body.query_pack string Required A Base64-encoded tarball containing a CodeQL query and all its dependencies
body.repositories array Optional List of repository names (in the form owner/repo-name) to run the query against. Precisely one property from repositories, repository_lists and repository_owners is required.
body.repositories[] string Optional
body.repository_lists array Optional List of repository lists to run the query against. Precisely one property from repositories, repository_lists and repository_owners is required. maxItems: 1
body.repository_lists[] string Optional
body.repository_owners array Optional List of organization or user names whose repositories the query should be run against. Precisely one property from repositories, repository_lists and repository_owners is required. maxItems: 1
body.repository_owners[] string Optional
body — Required oneOf[1]
body — Required oneOf[2]
body — Required oneOf[3]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "language": "csharp",
    "query_pack": "aGVsbG8=",
    "repositories": [
      "octocat/Hello-World",
      "octocat/example"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the summary of a CodeQL variant analysis — github.code-scanning.get-variant-analysis

Run Get the summary of a CodeQL variant analysis with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.codeql_variant_analysis_id integer Required The unique identifier of the variant analysis.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "codeql_variant_analysis_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the analysis status of a repository in a CodeQL variant analysis — github.code-scanning.get-variant-analysis-repo-task

Run Get the analysis status of a repository in a CodeQL variant analysis with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the controller repository.
path.codeql_variant_analysis_id integer Required The ID of the variant analysis.
path.repo_owner string Required The account owner of the variant analysis repository. The name is not case sensitive.
path.repo_name string Required The name of the variant analysis repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "codeql_variant_analysis_id": 1,
    "repo_owner": "example",
    "repo_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a code scanning default setup configuration — github.code-scanning.get-default-setup

Run Get a code scanning default setup configuration with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a code scanning default setup configuration — github.code-scanning.update-default-setup

Run Update a code scanning default setup configuration with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body — Required $ref: "#/definitions/code-scanning-default-setup-update"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {}
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Upload an analysis as SARIF data — github.code-scanning.upload-sarif

Run Upload an analysis as SARIF data with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required additionalProperties: false
body.commit_sha — Required $ref: "#/definitions/code-scanning-analysis-commit-sha"
body.ref — Required $ref: "#/definitions/code-scanning-ref-full"
body.sarif — Required $ref: "#/definitions/code-scanning-analysis-sarif-file"
body.checkout_uri string Optional The base directory used in the analysis, as it appears in the SARIF file. This property is used to convert file paths from absolute to relative, so that alerts can be mapped to their correct location in the repository. format: "uri"
body.started_at string Optional The time that the analysis run began. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
body.tool_name string Optional The name of the tool used to generate the code scanning analysis. If this parameter is not used, the tool name defaults to "API". If the uploaded SARIF contains a tool GUID, this will be available for filtering using the tool_guid parameter of operations such as GET /repos/{owner}/{repo}/code-scanning/alerts.
body.validate boolean Optional Whether the SARIF file will be validated according to the code scanning specifications. This parameter is intended to help integrators ensure that the uploaded SARIF files are correctly rendered by code scanning.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "commit_sha": "4b6472266afd7b471e86085a6659e8c7f2b119da",
    "ref": "refs/heads/master",
    "sarif": "H4sICMLGdF4AA2V4YW1wbGUuc2FyaWYAvVjdbts2FL7PUxDCijaA/CM7iRNfLkPXYgHSNstumlzQ0pHFVCI1korjFgH2ONtr7Ul2KFmy/mOn6QIkjsjDw0/nfN85NL8dEGL9pNwAImqRObECrWM1H40kXQ2XTAfJIlEgXcE1cD10RTQSVDE10K4aKSqZP1AxuKOIKg1ydJU60jSfSh8Hk6EzHA/vlOCWbfa7B6kYPpj90rlsWCZcmbHP5Bs+4oAWIjQD2SMOeJLh2vIQDnIaQerqXHjw8YIgxohybxAyDsS4cAPKsp03K4RcUs6+Up2D+JXpd8mibKIQN9fM/aMCdbyBujGSSQgVxJtx5qX2d2qUcIweQhEuDQf3GBO6CKHkogx/N3MVCKl/AeVKFuf4y5ubsMGDTj1ep+5I7sgmLIpxtU38hLtmMRGSuCFVyip5eKzs5ydh+LztVL6f2m6oih1BkYiuyQIIJWodxVpERPj4sEiWBNNH8EWT0DMG8EAjzKVHXCrB4FkPu/F64NMk1OeC+2yZSNoBOoR7CC0EzYWGbm+xFDFIzbI011+cLjfZtyJkmMZfumAh02uL3NpV2y+MZ6RAjxibyKrNxxJcVjANSb4eBGwZ1M0KsuyR2poLr5rMl8vaDSeVn6eTWEO2j2xIEcmhwlTKNOi4GMOI8gfuZYkvJ7b4v5Tiumyz7RnHeodFzpS8ASIZCH/AYdWi2z3sG8JtFxJ6fF9yR9CdifBr9Pd6d5V2+zbJKjjCFGGmsHuYFy2ytJq9tUxcLSRSQecppOGKrpUxYfxefMEFK+wOGa4hudQByBVT0L+EKtyACxnRsABhEx1QjVDs1KNI9MbpnhqfE45B6FJvu3hRu5VRU9MhZLmK7fqkKyQSTHNoyMqUFMqXCV3CwAeqEwmVokraK8IuBaGvHjQ0gMYrKjnjyw7uk9uD8tgmsBbFMPnU1bV2ZhkJNkuolUiWys3UPWzs5aaIUz9TBe8zMb+6+nT+6fLy91dlE3xzeDDT4zYszb0bW6NjJd0Rvn2EnLvWLFSdKPpBzInzfRgu8ETyMcH8nIfMnJCeC2PyfTA+UKngcnGH7Hw2hGkVQs5YlIRCtdWZYQ4/73es2JlxkfViOEIhoWJq5Oo6UBBfiKIqFBWhiE3jJGbFwVoxBHTRSuIS67sMeplei24X20shLjG+8gqbKC/bESiNMC+wd5q5id0yeS7CJEqXzmrTWNq3k05l84P6f4/bEmXFJjI0fIt1BGQssUnUDkBYeVhE5TqPnMH3jqogDcP0zKcTgLPTMSzOjhbjuVOmW23l1fYNStulfo6sXlFsGLhbDy5RECPRYGCTgOj2bd4nUQEivEd0H7KKYxqnEhFohuur3a3UPskbH/+Yg0+M5P2MHRJu3ziHh3Z2NCrWt3XF1rWTw8Ne/pfbWYXnDSE0SNZQQt1i18q7te2vOhu7ehWuvVyeu0wbLZi24mhoo6aOOTltzG/lgdVvVoXQq5V+pewkFIzL8fjEcadT55jOjpzFzHuOTtDNrMkJPMVQDd7F09RID72O/UPZ0tmctqZ7kWX6EmSZnDpP8GU67SXM8XE3YSrxbKsx6UReZ4y6n/FVZfJjs9Z7stma75W5yQtkzjk5eSJxk1lv4o7+j8TlhaJ2lsKWZO6lruDPBLib3x5ZN/KGWzZ+pn///evv7OOf4iIBv3oY9L/l1wiJ9p0Tc+F1zZnOE9NxXWEus6IQhr5pMfoqxi8WPsuu0azsns4UC6WzNzHIzbeEx4P/AJ3SefgcFAAA"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get information about a SARIF upload — github.code-scanning.get-sarif

Run Get information about a SARIF upload with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.sarif_id string Required The SARIF ID obtained after uploading.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "sarif_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the code security configuration associated with a repository — github.code-security.get-configuration-for-repository

Run Get the code security configuration associated with a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List CODEOWNERS errors — github.repos.codeowners-errors

Run List CODEOWNERS errors with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.ref string Optional A branch, tag or commit name used to determine which version of the CODEOWNERS file to use. Default: the repository's default branch (e.g. main)

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List codespaces in a repository for the authenticated user — github.codespaces.list-in-repository-for-authenticated-user

Run List codespaces in a repository for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a codespace in a repository — github.codespaces.create-with-repo-for-authenticated-user

Run Create a codespace in a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object | null Required
body.ref string Optional Git ref (typically a branch name) for this codespace
body.location string Optional The requested location for a new codespace. Best efforts are made to respect this upon creation. Assigned by IP if not provided.
body.geo string Optional The geographic area for this codespace. If not specified, the value is assigned by IP. This property replaces location, which is closing down. enum: ["EuropeWest","SoutheastAsia","UsEast","UsWest"]
body.client_ip string Optional IP for location auto-detection when proxying a request
body.machine string Optional Machine type to use for this codespace
body.devcontainer_path string Optional Path to devcontainer.json config to use for this codespace
body.multi_repo_permissions_opt_out boolean Optional Whether to authorize requested permissions from devcontainer.json
body.working_directory string Optional Working directory for this codespace
body.idle_timeout_minutes integer Optional Time in minutes before codespace stops from inactivity
body.display_name string Optional Display name for this codespace
body.retention_period_minutes integer Optional Duration in minutes after codespace has gone idle in which it will be deleted. Must be integer minutes between 0 and 43200 (30 days).

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "ref": "main",
    "machine": "standardLinux32gb"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List devcontainer configurations in a repository for the authenticated user — github.codespaces.list-devcontainers-in-repository-for-authenticated-user

Run List devcontainer configurations in a repository for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List available machine types for a repository — github.codespaces.repo-machines-for-authenticated-user

Run List available machine types for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.location string Optional The location to check for available machines. Assigned by IP if not provided.
query.client_ip string Optional IP for location auto-detection when proxying a request
query.ref string Optional The branch or commit to check for prebuild availability and devcontainer restrictions.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get default attributes for a codespace — github.codespaces.pre-flight-with-repo-for-authenticated-user

Run Get default attributes for a codespace with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.ref string Optional The branch or commit to check for a default devcontainer path. If not specified, the default branch will be checked.
query.client_ip string Optional An alternative IP for default location auto-detection, such as when proxying a request.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check if permissions defined by a devcontainer have been accepted by the authenticated user — github.codespaces.check-permissions-for-devcontainer

Run Check if permissions defined by a devcontainer have been accepted by the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Required additionalProperties: false
query.ref string Required The git reference that points to the location of the devcontainer configuration to use for the permission check. The value of ref will typically be a branch name (heads/BRANCH_NAME). For more information, see "Git References" in the Git documentation.
query.devcontainer_path string Required Path to the devcontainer.json configuration to use for the permission check.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "query": {
    "ref": "master",
    "devcontainer_path": ".devcontainer/example/devcontainer.json"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository secrets — github.codespaces.list-repo-secrets

Run List repository secrets with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository public key — github.codespaces.get-repo-public-key

Run Get a repository public key with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository secret — github.codespaces.get-repo-secret

Run Get a repository secret with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update a repository secret — github.codespaces.create-or-update-repo-secret

Run Create or update a repository secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.secret_name string Required The name of the secret.
body object Required
body.encrypted_value string Optional Value for your secret, encrypted with LibSodium using the public key retrieved from the Get a repository public key endpoint. pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$"
body.key_id string Optional ID of the key you used to encrypt the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "secret_name": "example"
  },
  "body": {
    "encrypted_value": "c2VjcmV0",
    "key_id": "012345678912345678"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a repository secret — github.codespaces.delete-repo-secret

Run Delete a repository secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository collaborators — github.repos.list-collaborators

Run List repository collaborators with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.affiliation string Optional Filter collaborators returned by their affiliation. outside means all outside collaborators of an organization-owned repository. direct means all collaborators with permissions to an organization-owned repository, regardless of organization membership status. all means all collaborators the authenticated user can see. enum: ["outside","direct","all"]; default: "all"
query.permission string Optional Filter collaborators by the permissions they have on the repository. If not specified, all collaborators will be returned. enum: ["pull","triage","triage_plus","push","maintain","admin"]
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check if a user is a repository collaborator — github.repos.check-collaborator

Run Check if a user is a repository collaborator with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add a repository collaborator — github.repos.add-collaborator

Run Add a repository collaborator with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.
body object Optional
body.permission string Optional The permission to grant the collaborator. Only valid on organization-owned repositories. We accept the following permissions to be set: pull, triage, triage_plus, push, maintain, admin and you can also specify a custom repository role name, if the owning organization has defined any. default: "push"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove a repository collaborator — github.repos.remove-collaborator

Run Remove a repository collaborator with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get repository permissions for a user — github.repos.get-collaborator-permission-level

Run Get repository permissions for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List commit comments for a repository — github.repos.list-commit-comments-for-repo

Run List commit comments for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a commit comment — github.repos.get-commit-comment

Run Get a commit comment with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a commit comment — github.repos.update-commit-comment

Run Update a commit comment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.
body object Required
body.body string Required The contents of the comment

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1
  },
  "body": {
    "body": "Nice change"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a commit comment — github.repos.delete-commit-comment

Run Delete a commit comment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List reactions for a commit comment — github.reactions.list-for-commit-comment

Run List reactions for a commit comment with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.
query object Optional additionalProperties: false
query.content string Optional Returns a single reaction type. Omit this parameter to list all reactions to a commit comment. enum: ["+1","-1","laugh","confused","heart","hooray","rocket","eyes"]
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create reaction for a commit comment — github.reactions.create-for-commit-comment

Run Create reaction for a commit comment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.
body object Required
body.content string Required The reaction type to add to the commit comment. enum: ["+1","-1","laugh","confused","heart","hooray","rocket","eyes"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1
  },
  "body": {
    "content": "heart"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a commit comment reaction — github.reactions.delete-for-commit-comment

Run Delete a commit comment reaction with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.
path.reaction_id integer Required The unique identifier of the reaction.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1,
    "reaction_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List commits — github.repos.list-commits

Run List commits with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.sha string Optional SHA or branch to start listing commits from. Default: the repository’s default branch (usually main).
query.path string Optional Only commits containing this file path will be returned.
query.author string Optional GitHub username or email address to use to filter by commit author.
query.committer string Optional GitHub username or email address to use to filter by commit committer.
query.since string Optional Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. Due to limitations of Git, timestamps must be between 1970-01-01 and 2099-12-31 (inclusive) or unexpected results may be returned. format: "date-time"
query.until string Optional Only commits before this date will be returned. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. Due to limitations of Git, timestamps must be between 1970-01-01 and 2099-12-31 (inclusive) or unexpected results may be returned. format: "date-time"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List branches for HEAD commit — github.repos.list-branches-for-head-commit

Run List branches for HEAD commit with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.commit_sha string Required The SHA of the commit.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "commit_sha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List commit comments — github.repos.list-comments-for-commit

Run List commit comments with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.commit_sha string Required The SHA of the commit.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "commit_sha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a commit comment — github.repos.create-commit-comment

Run Create a commit comment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.commit_sha string Required The SHA of the commit.
body object Required
body.body string Required The contents of the comment.
body.path string Optional Relative path of the file to comment on.
body.position integer Optional Line index in the diff to comment on.
body.line integer Optional Closing down notice. Use position parameter instead. Line number in the file to comment on.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "commit_sha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  },
  "body": {
    "body": "Great stuff",
    "path": "file1.txt",
    "position": 4,
    "line": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List pull requests associated with a commit — github.repos.list-pull-requests-associated-with-commit

Run List pull requests associated with a commit with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.commit_sha string Required The SHA of the commit.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "commit_sha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a commit — github.repos.get-commit

Run Get a commit with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ref string Required The commit reference. Can be a commit SHA, branch name (heads/BRANCH_NAME), or tag name (tags/TAG_NAME). For more information, see "Git References" in the Git documentation.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ref": "heads/main"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List check runs for a Git reference — github.checks.list-for-ref

Run List check runs for a Git reference with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ref string Required The commit reference. Can be a commit SHA, branch name (heads/BRANCH_NAME), or tag name (tags/TAG_NAME). For more information, see "Git References" in the Git documentation.
query object Optional additionalProperties: false
query.check_name string Optional Returns check runs with the specified name.
query.status string Optional Returns check runs with the specified status. enum: ["queued","in_progress","completed"]
query.filter string Optional Filters check runs by their completed_at timestamp. latest returns the most recent check runs. enum: ["latest","all"]; default: "latest"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.app_id integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ref": "heads/main"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List check suites for a Git reference — github.checks.list-suites-for-ref

Run List check suites for a Git reference with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ref string Required The commit reference. Can be a commit SHA, branch name (heads/BRANCH_NAME), or tag name (tags/TAG_NAME). For more information, see "Git References" in the Git documentation.
query object Optional additionalProperties: false
query.app_id integer Optional Filters check suites by GitHub App id.
query.check_name string Optional Returns check runs with the specified name.
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ref": "heads/main"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the combined status for a specific reference — github.repos.get-combined-status-for-ref

Run Get the combined status for a specific reference with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ref string Required The commit reference. Can be a commit SHA, branch name (heads/BRANCH_NAME), or tag name (tags/TAG_NAME). For more information, see "Git References" in the Git documentation.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ref": "heads/main"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List commit statuses for a reference — github.repos.list-commit-statuses-for-ref

Run List commit statuses for a reference with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ref string Required The commit reference. Can be a commit SHA, branch name (heads/BRANCH_NAME), or tag name (tags/TAG_NAME). For more information, see "Git References" in the Git documentation.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ref": "heads/main"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get community profile metrics — github.repos.get-community-profile-metrics

Run Get community profile metrics with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Compare two commits — github.repos.compare-commits

Run Compare two commits with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.basehead string Required The base branch and head branch to compare. This parameter expects the format BASE...HEAD. Both must be branch names in repo. To compare with a branch that exists in a different repository in the same network as repo, the basehead parameter expects the format USERNAME:BASE...USERNAME:HEAD.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "basehead": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update file contents — github.repos.create-or-update-file-contents

Run Create or update file contents with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.path string Required path parameter
body object Required
body.message string Required The commit message.
body.content string Required The new file content, using Base64 encoding.
body.sha string Optional Required if you are updating a file. The blob SHA of the file being replaced.
body.branch string Optional The branch name. Default: the repository’s default branch.
body.committer object Optional The person that committed the file. Default: the authenticated user.
body.committer.name string Required The name of the author or committer of the commit. You'll receive a 422 status code if name is omitted.
body.committer.email string Required The email of the author or committer of the commit. You'll receive a 422 status code if email is omitted.
body.committer.date string Optional
body.author object Optional The author of the file. Default: The committer or the authenticated user if you omit committer.
body.author.name string Required The name of the author or committer of the commit. You'll receive a 422 status code if name is omitted.
body.author.email string Required The email of the author or committer of the commit. You'll receive a 422 status code if email is omitted.
body.author.date string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "path": "example"
  },
  "body": {
    "message": "my commit message",
    "committer": {
      "name": "Monalisa Octocat",
      "email": "[email protected]"
    },
    "content": "bXkgbmV3IGZpbGUgY29udGVudHM="
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a file — github.repos.delete-file

Run Delete a file with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.path string Required path parameter
body object Required
body.message string Required The commit message.
body.sha string Required The blob SHA of the file being deleted.
body.branch string Optional The branch name. Default: the repository’s default branch
body.committer object Optional object containing information about the committer.
body.committer.name string Optional The name of the author (or committer) of the commit
body.committer.email string Optional The email of the author (or committer) of the commit
body.author object Optional object containing information about the author.
body.author.name string Optional The name of the author (or committer) of the commit
body.author.email string Optional The email of the author (or committer) of the commit

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "path": "example"
  },
  "body": {
    "message": "my commit message",
    "committer": {
      "name": "Monalisa Octocat",
      "email": "[email protected]"
    },
    "sha": "329688480d39049927147c162b9d2deaf885005f"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository contributors — github.repos.list-contributors

Run List repository contributors with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.anon string Optional Set to 1 or true to include anonymous contributors in results.
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get Copilot cloud agent configuration for a repository — github.copilot.get-copilot-cloud-agent-configuration

Run Get Copilot cloud agent configuration for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List Dependabot alerts for a repository — github.dependabot.list-alerts-for-repo

Run List Dependabot alerts for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.classification string Optional A comma-separated list of vulnerability classifications. If specified, only alerts for vulnerabilities with these classifications will be returned. Can be: malware, general
query.state string Optional A comma-separated list of states. If specified, only alerts with these states will be returned. Can be: auto_dismissed, dismissed, fixed, open
query.severity string Optional A comma-separated list of severities. If specified, only alerts with these severities will be returned. Can be: low, medium, high, critical
query.ecosystem string Optional A comma-separated list of ecosystems. If specified, only alerts for these ecosystems will be returned. Can be: composer, go, maven, npm, nuget, pip, pub, rubygems, rust
query.package string Optional A comma-separated list of package names. If specified, only alerts for these packages will be returned.
query.manifest string Optional A comma-separated list of full manifest paths. If specified, only alerts for these manifests will be returned.
query.epss_percentage string Optional CVE Exploit Prediction Scoring System (EPSS) percentage. Can be specified as: - An exact number (n) - Comparators such as >n, <n, >=n, <=n - A range like n..n, where n is a number from 0.0 to 1.0 Filters the list of alerts based on EPSS percentages. If specified, only alerts with the provided EPSS percentages will be returned.
query.has — Optional Filters the list of alerts based on whether the alert has the given value. If specified, only alerts meeting this criterion will be returned. Multiple has filters can be passed to filter for alerts that have all of the values. Currently, only patch is supported.
query.has string Optional oneOf[1]
query.has array Optional oneOf[2]
query.has[] string Optional oneOf[2]; enum: ["patch"]
query.assignee string Optional Filter alerts by assignees. Provide a comma-separated list of user handles (e.g., octocat or octocat,hubot) to return alerts assigned to any of the specified users. Use * to list alerts with at least one assignee or none to list alerts with no assignees.
query.scope string Optional The scope of the vulnerable dependency. If specified, only alerts with this scope will be returned. enum: ["development","runtime"]
query.relationship string Optional A comma-separated list of relationships of the vulnerable dependency to your project. If specified, only alerts with these relationships will be returned. > [!NOTE] > We are rolling out support for dependency relationship across ecosystems. This value will be "unknown" for all dependencies in unsupported ecosystems.
query.sort string Optional The property by which to sort the results. created means when the alert was created. updated means when the alert's state last changed. epss_percentage sorts alerts by the Exploit Prediction Scoring System (EPSS) percentage. enum: ["created","updated","epss_percentage"]; default: "created"
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a Dependabot alert — github.dependabot.get-alert

Run Get a Dependabot alert with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.alert_number — Required The number that identifies a Dependabot alert in its repository. You can find this at the end of the URL for a Dependabot alert within GitHub, or in number fields in the response from the GET /repos/{owner}/{repo}/dependabot/alerts operation. $ref: "#/definitions/alert-number"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "alert_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a Dependabot alert — github.dependabot.update-alert

Run Update a Dependabot alert with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.alert_number — Required The number that identifies a Dependabot alert in its repository. You can find this at the end of the URL for a Dependabot alert within GitHub, or in number fields in the response from the GET /repos/{owner}/{repo}/dependabot/alerts operation. $ref: "#/definitions/alert-number"
body object Required additionalProperties: false
body.state string Optional The state of the Dependabot alert. A dismissed_reason must be provided when setting the state to dismissed. enum: ["dismissed","open"]
body.dismissed_reason string Optional Required when state is dismissed. A reason for dismissing the alert. enum: ["fix_started","inaccurate","no_bandwidth","not_used","tolerable_risk"]
body.dismissed_comment string Optional An optional comment associated with dismissing the alert. maxLength: 280
body.assignees array Optional Usernames to assign to this Dependabot Alert. Pass one or more user logins to replace the set of assignees on this alert. Send an empty array ([]) to clear all assignees from the alert. To assign an AI agent, include the bot login (for example, copilot-swe-agent[bot]).
body.assignees[] string Optional
body.agent_assignment object Optional Parameters for AI agent assignment. Only used when an agent bot login is included in assignees. Ignored when no agent is being assigned. additionalProperties: false
body.agent_assignment.custom_instructions string Optional Custom instructions for the agent.
body.agent_assignment.custom_agent string Optional A custom agent identifier.
body.agent_assignment.model string Optional The model to use for the agent.
body — Required anyOf[1]
body — Required anyOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "alert_number": 1
  },
  "body": {
    "state": "dismissed",
    "dismissed_reason": "tolerable_risk",
    "dismissed_comment": "This alert is accurate but we use a sanitizer."
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository secrets — github.dependabot.list-repo-secrets

Run List repository secrets with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository public key — github.dependabot.get-repo-public-key

Run Get a repository public key with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository secret — github.dependabot.get-repo-secret

Run Get a repository secret with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update a repository secret — github.dependabot.create-or-update-repo-secret

Run Create or update a repository secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.secret_name string Required The name of the secret.
body object Required
body.encrypted_value string Optional Value for your secret, encrypted with LibSodium using the public key retrieved from the Get a repository public key endpoint. pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$"
body.key_id string Optional ID of the key you used to encrypt the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "secret_name": "example"
  },
  "body": {
    "encrypted_value": "c2VjcmV0",
    "key_id": "012345678912345678"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a repository secret — github.dependabot.delete-repo-secret

Run Delete a repository secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a diff of the dependencies between commits — github.dependency-graph.diff-range

Run Get a diff of the dependencies between commits with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.basehead string Required The base and head Git revisions to compare. The Git revisions will be resolved to commit SHAs. Named revisions will be resolved to their corresponding HEAD commits, and an appropriate merge base will be determined. This parameter expects the format {base}...{head}.
query object Optional additionalProperties: false
query.name string Optional The full path, relative to the repository root, of the dependency manifest file.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "basehead": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Fetch a software bill of materials (SBOM) for a repository. — github.dependency-graph.fetch-sbom-report

Run Fetch a software bill of materials (SBOM) for a repository. with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.sbom_uuid string Required The unique identifier of the SBOM export.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "sbom_uuid": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Request generation of a software bill of materials (SBOM) for a repository. — github.dependency-graph.generate-sbom-report

Run Request generation of a software bill of materials (SBOM) for a repository. with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a snapshot of dependencies for a repository — github.dependency-graph.create-repository-snapshot

Run Create a snapshot of dependencies for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body — Required $ref: "#/definitions/snapshot"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "detector": {
      "name": "docker buildtime detector",
      "version": "1.0.0",
      "url": "http://example.com/docker-buildtimer-detector"
    },
    "version": 1,
    "ref": "refs/heads/main",
    "sha": "ddc951f4b1293222421f2c8df679786153acf689",
    "job": {
      "id": "5622a2b0-63f6-4732-8c34-a1ab27e102a11",
      "correlator": "yourworkflowname_yourjobname"
    },
    "scanned": "2020-06-13T14:52:50-05:00"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List deployments — github.repos.list-deployments

Run List deployments with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.sha string Optional The SHA recorded at creation time. default: "none"
query.ref string Optional The name of the ref. This can be a branch, tag, or SHA. default: "none"
query.task string Optional The name of the task for the deployment (e.g., deploy or deploy:migrations). default: "none"
query.environment string | null Optional The name of the environment that was deployed to (e.g., staging or production). default: "none"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a deployment — github.repos.create-deployment

Run Create a deployment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.ref string Required The ref to deploy. This can be a branch, tag, or SHA.
body.task string Optional Specifies a task to execute (e.g., deploy or deploy:migrations). default: "deploy"
body.auto_merge boolean Optional Attempts to automatically merge the default branch into the requested ref, if it's behind the default branch. default: true
body.required_contexts array Optional The status contexts to verify against commit status checks. If you omit this parameter, GitHub verifies all unique contexts before creating a deployment. To bypass checking entirely, pass an empty array. Defaults to all unique contexts.
body.required_contexts[] string Optional
body.payload — Optional
body.payload object Optional oneOf[1]; additionalProperties: true
body.payload string Optional JSON payload with extra information about the deployment. oneOf[2]; default: ""
body.environment string Optional Name for the target deployment environment (e.g., production, staging, qa). default: "production"
body.description string | null Optional Short description of the deployment. default: ""
body.transient_environment boolean Optional Specifies if the given environment is specific to the deployment and will no longer exist at some point in the future. Default: false default: false
body.production_environment boolean Optional Specifies if the given environment is one that end-users directly interact with. Default: true when environment is production and false otherwise.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "ref": "topic-branch",
    "payload": "{ \"deploy\": \"migrate\" }",
    "description": "Deploy request from hubot"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a deployment — github.repos.get-deployment

Run Get a deployment with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.deployment_id integer Required deployment_id parameter

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "deployment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a deployment — github.repos.delete-deployment

Run Delete a deployment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.deployment_id integer Required deployment_id parameter

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "deployment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List deployment statuses — github.repos.list-deployment-statuses

Run List deployment statuses with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.deployment_id integer Required deployment_id parameter
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "deployment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a deployment status — github.repos.create-deployment-status

Run Create a deployment status with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.deployment_id integer Required deployment_id parameter
body object Required
body.state string Required The state of the status. When you set a transient deployment to inactive, the deployment will be shown as destroyed in GitHub. enum: ["error","failure","inactive","in_progress","queued","pending","success"]
body.target_url string Optional The target URL to associate with this status. This URL should contain output to keep the user updated while the task is running or serve as historical information for what happened in the deployment. > [!NOTE] > It's recommended to use the log_url parameter, which replaces target_url. default: ""
body.log_url string Optional The full URL of the deployment's output. This parameter replaces target_url. We will continue to accept target_url to support legacy uses, but we recommend replacing target_url with log_url. Setting log_url will automatically set target_url to the same value. Default: "" default: ""
body.description string Optional A short description of the status. The maximum description length is 140 characters. default: ""
body.environment string Optional Name for the target deployment environment, which can be changed when setting a deploy status. For example, production, staging, or qa. If not defined, the environment of the previous status on the deployment will be used, if it exists. Otherwise, the environment of the deployment will be used.
body.environment_url string Optional Sets the URL for accessing your environment. Default: "" default: ""
body.auto_inactive boolean Optional Adds a new inactive status to all prior non-transient, non-production environment deployments with the same repository and environment name as the created status's deployment. An inactive status is only added to deployments that had a success state. Default: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "deployment_id": 1
  },
  "body": {
    "environment": "production",
    "state": "success",
    "log_url": "https://example.com/deployment/42/output",
    "description": "Deployment finished successfully."
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a deployment status — github.repos.get-deployment-status

Run Get a deployment status with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.deployment_id integer Required deployment_id parameter
path.status_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "deployment_id": 1,
    "status_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a repository dispatch event — github.repos.create-dispatch-event

Run Create a repository dispatch event with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.event_type string Required A custom webhook event name. Must be 100 characters or fewer. minLength: 1; maxLength: 100
body.client_payload object Optional JSON payload with extra information about the webhook event that your action or workflow may use. The maximum number of top-level properties is 10. The total size of the JSON payload must be less than 64KB. maxProperties: 10; additionalProperties: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "event_type": "on-demand-test",
    "client_payload": {
      "unit": false,
      "integration": true
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List environments — github.repos.get-all-environments

Run List environments with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an environment — github.repos.get-environment

Run Get an environment with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "environment_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update an environment — github.repos.create-or-update-environment

Run Create or update an environment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
body object | null Optional additionalProperties: false
body.wait_timer — Optional $ref: "#/definitions/wait-timer"
body.prevent_self_review — Optional $ref: "#/definitions/prevent-self-review"
body.reviewers array | null Optional The people or teams that may review jobs that reference the environment. You can list up to six users or teams as reviewers. The reviewers must have at least read access to the repository. Only one of the required reviewers needs to approve the job for it to proceed.
body.reviewers[] object Optional
body.reviewers[].type — Optional $ref: "#/definitions/deployment-reviewer-type"
body.reviewers[].id integer Optional The id of the user or team who can review the deployment
body.deployment_branch_policy — Optional $ref: "#/definitions/deployment-branch-policy-settings"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "environment_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an environment — github.repos.delete-an-environment

Run Delete an environment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "environment_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List deployment branch policies — github.repos.list-deployment-branch-policies

Run List deployment branch policies with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "environment_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a deployment branch policy — github.repos.create-deployment-branch-policy

Run Create a deployment branch policy with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
body — Required $ref: "#/definitions/deployment-branch-policy-name-pattern-with-type"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "environment_name": "example"
  },
  "body": {
    "name": "release/*"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a deployment branch policy — github.repos.get-deployment-branch-policy

Run Get a deployment branch policy with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
path.branch_policy_id integer Required The unique identifier of the branch policy.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "environment_name": "example",
    "branch_policy_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a deployment branch policy — github.repos.update-deployment-branch-policy

Run Update a deployment branch policy with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
path.branch_policy_id integer Required The unique identifier of the branch policy.
body — Required $ref: "#/definitions/deployment-branch-policy-name-pattern"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "environment_name": "example",
    "branch_policy_id": 1
  },
  "body": {
    "name": "release/*"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a deployment branch policy — github.repos.delete-deployment-branch-policy

Run Delete a deployment branch policy with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
path.branch_policy_id integer Required The unique identifier of the branch policy.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "environment_name": "example",
    "branch_policy_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get all deployment protection rules for an environment — github.repos.get-all-deployment-protection-rules

Run Get all deployment protection rules for an environment with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.owner string Required The account owner of the repository. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "environment_name": "example",
    "repo": "hello-world",
    "owner": "octocat"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a custom deployment protection rule on an environment — github.repos.create-deployment-protection-rule

Run Create a custom deployment protection rule on an environment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.owner string Required The account owner of the repository. The name is not case sensitive.
body object Required
body.integration_id integer Optional The ID of the custom app that will be enabled on the environment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "environment_name": "example",
    "repo": "hello-world",
    "owner": "octocat"
  },
  "body": {
    "integration_id": 5
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List custom deployment rule integrations available for an environment — github.repos.list-custom-deployment-rule-integrations

Run List custom deployment rule integrations available for an environment with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.owner string Required The account owner of the repository. The name is not case sensitive.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "environment_name": "example",
    "repo": "hello-world",
    "owner": "octocat"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a custom deployment protection rule — github.repos.get-custom-deployment-protection-rule

Run Get a custom deployment protection rule with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
path.protection_rule_id integer Required The unique identifier of the protection rule.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "environment_name": "example",
    "protection_rule_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Disable a custom protection rule for an environment — github.repos.disable-deployment-protection-rule

Run Disable a custom protection rule for an environment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.protection_rule_id integer Required The unique identifier of the protection rule.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "environment_name": "example",
    "repo": "hello-world",
    "owner": "octocat",
    "protection_rule_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List environment secrets — github.actions.list-environment-secrets

Run List environment secrets with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "environment_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an environment public key — github.actions.get-environment-public-key

Run Get an environment public key with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "environment_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an environment secret — github.actions.get-environment-secret

Run Get an environment secret with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "environment_name": "example",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update an environment secret — github.actions.create-or-update-environment-secret

Run Create or update an environment secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
path.secret_name string Required The name of the secret.
body object Required
body.encrypted_value string Required Value for your secret, encrypted with LibSodium using the public key retrieved from the Get an environment public key endpoint. pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$"
body.key_id string Required ID of the key you used to encrypt the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "environment_name": "example",
    "secret_name": "example"
  },
  "body": {
    "encrypted_value": "c2VjcmV0",
    "key_id": "012345678912345678"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an environment secret — github.actions.delete-environment-secret

Run Delete an environment secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "environment_name": "example",
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List environment variables — github.actions.list-environment-variables

Run List environment variables with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 30). For more information, see "Using pagination in the REST API." default: 10
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "environment_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an environment variable — github.actions.create-environment-variable

Run Create an environment variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
body object Required
body.name string Required The name of the variable.
body.value string Required The value of the variable.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "environment_name": "example"
  },
  "body": {
    "name": "USERNAME",
    "value": "octocat"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an environment variable — github.actions.get-environment-variable

Run Get an environment variable with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
path.name string Required The name of the variable.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "environment_name": "example",
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update an environment variable — github.actions.update-environment-variable

Run Update an environment variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.name string Required The name of the variable.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.
body object Required
body.name string Optional The name of the variable.
body.value string Optional The value of the variable.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "name": "example",
    "environment_name": "example"
  },
  "body": {
    "name": "USERNAME",
    "value": "octocat"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an environment variable — github.actions.delete-environment-variable

Run Delete an environment variable with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.name string Required The name of the variable.
path.environment_name string Required The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "name": "example",
    "environment_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository events — github.activity.list-repo-events

Run List repository events with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List forks — github.repos.list-forks

Run List forks with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.sort string Optional The sort order. stargazers will sort by star count. enum: ["newest","oldest","stargazers","watchers"]; default: "newest"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a fork — github.repos.create-fork

Run Create a fork with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object | null Optional
body.organization string Optional Optional parameter to specify the organization name if forking into an organization.
body.name string Optional When forking from an existing repository, a new name for the fork.
body.default_branch_only boolean Optional When forking from an existing repository, fork with only the default branch.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a blob — github.git.create-blob

Run Create a blob with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.content string Required The new blob's content.
body.encoding string Optional The encoding used for content. Currently, "utf-8" and "base64" are supported. default: "utf-8"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "content": "Content of the blob",
    "encoding": "utf-8"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a blob — github.git.get-blob

Run Get a blob with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.file_sha string Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "file_sha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a commit — github.git.create-commit

Run Create a commit with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.message string Required The commit message
body.tree string Required The SHA of the tree object this commit points to
body.parents array Optional The full SHAs of the commits that were the parents of this commit. If omitted or empty, the commit will be written as a root commit. For a single parent, an array of one SHA should be provided; for a merge commit, an array of more than one should be provided.
body.parents[] string Optional
body.author object Optional Information about the author of the commit. By default, the author will be the authenticated user and the current date. See the author and committer object below for details.
body.author.name string Required The name of the author (or committer) of the commit
body.author.email string Required The email of the author (or committer) of the commit
body.author.date string Optional Indicates when this commit was authored (or committed). This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
body.committer object Optional Information about the person who is making the commit. By default, committer will use the information set in author. See the author and committer object below for details.
body.committer.name string Optional The name of the author (or committer) of the commit
body.committer.email string Optional The email of the author (or committer) of the commit
body.committer.date string Optional Indicates when this commit was authored (or committed). This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
body.signature string Optional The PGP signature of the commit. GitHub adds the signature to the gpgsig header of the created commit. For a commit signature to be verifiable by Git or GitHub, it must be an ASCII-armored detached PGP signature over the string commit as it would be written to the object database. To pass a signature parameter, you need to first manually create a valid PGP signature, which can be complicated. You may find it easier to use the command line to create signed commits.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "message": "my commit message",
    "author": {
      "name": "Mona Octocat",
      "email": "[email protected]",
      "date": "2008-07-09T16:13:30+12:00"
    },
    "parents": [
      "7d1b31e74ee336d15cbd21741bc88a537ed063a0"
    ],
    "tree": "827efc6d56897b048c772eb4087f854f46256132",
    "signature": "-----BEGIN PGP SIGNATURE-----\n\niQIzBAABAQAdFiEESn/54jMNIrGSE6Tp6cQjvhfv7nAFAlnT71cACgkQ6cQjvhfv\n7nCWwA//XVqBKWO0zF+bZl6pggvky3Oc2j1pNFuRWZ29LXpNuD5WUGXGG209B0hI\nDkmcGk19ZKUTnEUJV2Xd0R7AW01S/YSub7OYcgBkI7qUE13FVHN5ln1KvH2all2n\n2+JCV1HcJLEoTjqIFZSSu/sMdhkLQ9/NsmMAzpf/iIM0nQOyU4YRex9eD1bYj6nA\nOQPIDdAuaTQj1gFPHYLzM4zJnCqGdRlg0sOM/zC5apBNzIwlgREatOYQSCfCKV7k\nnrU34X8b9BzQaUx48Qa+Dmfn5KQ8dl27RNeWAqlkuWyv3pUauH9UeYW+KyuJeMkU\n+NyHgAsWFaCFl23kCHThbLStMZOYEnGagrd0hnm1TPS4GJkV4wfYMwnI4KuSlHKB\njHl3Js9vNzEUQipQJbgCgTiWvRJoK3ENwBTMVkKHaqT4x9U4Jk/XZB6Q8MA09ezJ\n3QgiTjTAGcum9E9QiJqMYdWQPWkaBIRRz5cET6HPB48YNXAAUsfmuYsGrnVLYbG+\nUpC6I97VybYHTy2O9XSGoaLeMI9CsFn38ycAxxbWagk5mhclNTP5mezIq6wKSwmr\nX11FW3n1J23fWZn5HJMBsRnUCgzqzX3871IqLYHqRJ/bpZ4h20RhTyPj5c/z7QXp\neSakNQMfbbMcljkha+ZMuVQX1K9aRlVqbmv3ZMWh+OijLYVU2bc=\n=5Io4\n-----END PGP SIGNATURE-----\n"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a commit object — github.git.get-commit

Run Get a commit object with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.commit_sha string Required The SHA of the commit.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "commit_sha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List matching references — github.git.list-matching-refs

Run List matching references with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ref string Required The Git reference. For more information, see "Git References" in the Git documentation.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ref": "heads/feature-a"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a reference — github.git.get-ref

Run Get a reference with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ref string Required The Git reference. For more information, see "Git References" in the Git documentation.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ref": "heads/feature-a"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a reference — github.git.create-ref

Run Create a reference with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.ref string Required The name of the fully qualified reference (ie: refs/heads/master). If it doesn't start with 'refs' and have at least two slashes, it will be rejected.
body.sha string Required The SHA1 value for this reference.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "ref": "refs/heads/featureA",
    "sha": "aa218f56b14c9653891f9e74264a383fa43fefbd"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a reference — github.git.update-ref

Run Update a reference with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ref string Required The Git reference. For more information, see "Git References" in the Git documentation.
body object Required
body.sha string Required The SHA1 value to set this reference to
body.force boolean Optional Indicates whether to force the update or to make sure the update is a fast-forward update. Leaving this out or setting it to false will make sure you're not overwriting work. default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ref": "heads/feature-a"
  },
  "body": {
    "sha": "aa218f56b14c9653891f9e74264a383fa43fefbd",
    "force": true
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a reference — github.git.delete-ref

Run Delete a reference with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ref string Required The Git reference. For more information, see "Git References" in the Git documentation.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ref": "heads/feature-a"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a tag object — github.git.create-tag

Run Create a tag object with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.tag string Required The tag's name. This is typically a version (e.g., "v0.0.1").
body.message string Required The tag message.
body.object string Required The SHA of the git object this is tagging.
body.type string Required The type of the object we're tagging. Normally this is a commit but it can also be a tree or a blob. enum: ["commit","tree","blob"]
body.tagger object Optional An object with information about the individual creating the tag.
body.tagger.name string Required The name of the author of the tag
body.tagger.email string Required The email of the author of the tag
body.tagger.date string Optional When this object was tagged. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "tag": "v0.0.1",
    "message": "initial version",
    "object": "c3d0be41ecbe669545ee3e94d31ed9a4bc91ee3c",
    "type": "commit",
    "tagger": {
      "name": "Monalisa Octocat",
      "email": "[email protected]",
      "date": "2011-06-17T14:53:35-07:00"
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a tag — github.git.get-tag

Run Get a tag with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.tag_sha string Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "tag_sha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a tree — github.git.create-tree

Run Create a tree with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.tree array Required Objects (of path, mode, type, and sha) specifying a tree structure.
body.tree[] object Optional
body.tree[].path string Optional The file referenced in the tree.
body.tree[].mode string Optional The file mode; one of 100644 for file (blob), 100755 for executable (blob), 040000 for subdirectory (tree), 160000 for submodule (commit), or 120000 for a blob that specifies the path of a symlink. enum: ["100644","100755","040000","160000","120000"]
body.tree[].type string Optional Either blob, tree, or commit. enum: ["blob","tree","commit"]
body.tree[].sha string | null Optional The SHA1 checksum ID of the object in the tree. Also called tree.sha. If the value is null then the file will be deleted. Note: Use either tree.sha or content to specify the contents of the entry. Using both tree.sha and content will return an error.
body.tree[].content string Optional The content you want this file to have. GitHub will write this blob out and use that SHA for this entry. Use either this, or tree.sha. Note: Use either tree.sha or content to specify the contents of the entry. Using both tree.sha and content will return an error.
body.base_tree string Optional The SHA1 of an existing Git tree object which will be used as the base for the new tree. If provided, a new Git tree object will be created from entries in the Git tree object pointed to by base_tree and entries defined in the tree parameter. Entries defined in the tree parameter will overwrite items from base_tree with the same path. If you're creating new changes on a branch, then normally you'd set base_tree to the SHA1 of the Git tree object of the current latest commit on the branch you're working on. If not provided, GitHub will create a new Git tree object from only the entries defined in the tree parameter. If you create a new commit pointing to such a tree, then all files which were a part of the parent commit's tree and were not defined in the tree parameter will be listed as deleted by the new commit.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "base_tree": "9fb037999f264ba9a7fc6274d15fa3ae2ab98312",
    "tree": [
      {
        "path": "file.rb",
        "mode": "100644",
        "type": "blob",
        "sha": "44b4fc6d56897b048c772eb4087f854f46256132"
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a tree — github.git.get-tree

Run Get a tree with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.tree_sha string Required The SHA1 value or ref (branch or tag) name of the tree.
query object Optional additionalProperties: false
query.recursive string Optional Setting this parameter to any value returns the objects or subtrees referenced by the tree specified in :tree_sha. For example, setting recursive to any of the following will enable returning objects or subtrees: 0, 1, "true", and "false". Omit this parameter to prevent recursively returning objects or subtrees.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "tree_sha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the hash algorithm for a repository — github.repos.get-hash-algorithm

Run Get the hash algorithm for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository webhooks — github.repos.list-webhooks

Run List repository webhooks with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a repository webhook — github.repos.create-webhook

Run Create a repository webhook with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object | null Optional additionalProperties: false
body.name string Optional Use web to create a webhook. Default: web. This parameter only accepts the value web.
body.config object Optional Key/value pairs to provide settings for this webhook.
body.config.url — Optional $ref: "#/definitions/webhook-config-url"
body.config.content_type — Optional $ref: "#/definitions/webhook-config-content-type"
body.config.secret — Optional $ref: "#/definitions/webhook-config-secret"
body.config.insecure_ssl — Optional $ref: "#/definitions/webhook-config-insecure-ssl"
body.events array Optional Determines what events the hook is triggered for. default: ["push"]
body.events[] string Optional
body.active boolean Optional Determines if notifications are sent when the webhook is triggered. Set to true to send notifications. default: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository webhook — github.repos.get-webhook

Run Get a repository webhook with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "hook_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a repository webhook — github.repos.update-webhook

Run Update a repository webhook with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.
body object Required
body.config — Optional $ref: "#/definitions/webhook-config"
body.events array Optional Determines what events the hook is triggered for. This replaces the entire array of events. default: ["push"]
body.events[] string Optional
body.add_events array Optional Determines a list of events to be added to the list of events that the Hook triggers for.
body.add_events[] string Optional
body.remove_events array Optional Determines a list of events to be removed from the list of events that the Hook triggers for.
body.remove_events[] string Optional
body.active boolean Optional Determines if notifications are sent when the webhook is triggered. Set to true to send notifications. default: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "hook_id": 1
  },
  "body": {
    "active": true,
    "add_events": [
      "pull_request"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a repository webhook — github.repos.delete-webhook

Run Delete a repository webhook with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "hook_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a webhook configuration for a repository — github.repos.get-webhook-config-for-repo

Run Get a webhook configuration for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "hook_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a webhook configuration for a repository — github.repos.update-webhook-config-for-repo

Run Update a webhook configuration for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.
body object Optional additionalProperties: false
body.url — Optional $ref: "#/definitions/webhook-config-url"
body.content_type — Optional $ref: "#/definitions/webhook-config-content-type"
body.secret — Optional $ref: "#/definitions/webhook-config-secret"
body.insecure_ssl — Optional $ref: "#/definitions/webhook-config-insecure-ssl"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "hook_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List deliveries for a repository webhook — github.repos.list-webhook-deliveries

Run List deliveries for a repository webhook with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.cursor string Optional Used for pagination: the starting delivery from which the page of deliveries is fetched. Refer to the link header for the next and previous page cursors.
query.status string Optional Returns webhook deliveries filtered by delivery outcome classification based on status_code range. A status of success returns deliveries with a status_code in the 200-399 range (inclusive). A status of failure returns deliveries with a status_code in the 400-599 range (inclusive). enum: ["success","failure"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "hook_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a delivery for a repository webhook — github.repos.get-webhook-delivery

Run Get a delivery for a repository webhook with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.
path.delivery_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "hook_id": 1,
    "delivery_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Redeliver a delivery for a repository webhook — github.repos.redeliver-webhook-delivery

Run Redeliver a delivery for a repository webhook with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.
path.delivery_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "hook_id": 1,
    "delivery_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Ping a repository webhook — github.repos.ping-webhook

Run Ping a repository webhook with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "hook_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Test the push repository webhook — github.repos.test-push-webhook

Run Test the push repository webhook with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.hook_id integer Required The unique identifier of the hook. You can find this value in the X-GitHub-Hook-ID header of a webhook delivery.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "hook_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check if immutable releases are enabled for a repository — github.repos.check-immutable-releases

Run Check if immutable releases are enabled for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Enable immutable releases — github.repos.enable-immutable-releases

Run Enable immutable releases with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Disable immutable releases — github.repos.disable-immutable-releases

Run Disable immutable releases with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository installation for the authenticated app — github.apps.get-repo-installation

Run Get a repository installation for the authenticated app with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get interaction restrictions for a repository — github.interactions.get-restrictions-for-repo

Run Get interaction restrictions for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set interaction restrictions for a repository — github.interactions.set-restrictions-for-repo

Run Set interaction restrictions for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body — Required $ref: "#/definitions/interaction-limit"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "limit": "collaborators_only"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove interaction restrictions for a repository — github.interactions.remove-restrictions-for-repo

Run Remove interaction restrictions for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get pull request creation cap bypass list for a repository — github.interactions.get-pull-request-bypass-list-for-repo

Run Get pull request creation cap bypass list for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add users to the pull request creation cap bypass list for a repository — github.interactions.set-pull-request-bypass-list-for-repo

Run Add users to the pull request creation cap bypass list for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body — Required $ref: "#/definitions/interaction-limit-pull-request-bypass-list"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "users": [
      "octocat",
      "monalisa"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove users from the pull request creation cap bypass list for a repository — github.interactions.remove-pull-request-bypass-list-for-repo

Run Remove users from the pull request creation cap bypass list for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body — Required $ref: "#/definitions/interaction-limit-pull-request-bypass-list"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "users": [
      "octocat",
      "monalisa"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get pull request creation cap for a repository — github.interactions.get-pull-request-creation-cap-for-repo

Run Get pull request creation cap for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update pull request creation cap for a repository — github.interactions.update-pull-request-creation-cap-for-repo

Run Update pull request creation cap for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.enabled boolean Required Whether the pull request creation cap is enabled
body.max_open_pull_requests integer Optional The maximum number of open pull requests a user can have at one time minimum: 1; maximum: 1000
body.include_drafts boolean Optional Whether draft pull requests count toward the pull request creation cap

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "enabled": true,
    "max_open_pull_requests": 1,
    "include_drafts": true
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository invitations — github.repos.list-invitations

Run List repository invitations with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a repository invitation — github.repos.update-invitation

Run Update a repository invitation with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.invitation_id integer Required The unique identifier of the invitation.
body object Optional
body.permissions string Optional The permissions that the associated user will have on the repository. Valid values are read, write, maintain, triage, and admin. enum: ["read","write","maintain","triage","admin"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "invitation_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a repository invitation — github.repos.delete-invitation

Run Delete a repository invitation with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.invitation_id integer Required The unique identifier of the invitation.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "invitation_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List issue types for a repository — github.repos.list-issue-types

Run List issue types for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository issues — github.issues.list-for-repo

Run List repository issues with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.milestone string Optional If an integer is passed, it should refer to a milestone by its number field. If the string * is passed, issues with any milestone are accepted. If the string none is passed, issues without milestones are returned.
query.state string Optional Indicates the state of the issues to return. enum: ["open","closed","all"]; default: "open"
query.assignee string Optional Can be the name of a user. Pass in none for issues with no assigned user, and * for issues assigned to any user.
query.type string Optional Can be the name of an issue type. If the string * is passed, issues with any type are accepted. If the string none is passed, issues without type are returned.
query.creator string Optional The user that created the issue.
query.mentioned string Optional A user that's mentioned in the issue.
query.issue_field_values string Optional A comma-separated list of issue field filters in field_slug:value format. Only issues matching all specified field values are returned. Requires issue fields to be enabled for the repository. Issue fields are not available for user-owned repositories, and field availability for organization-owned public repositories depends on the organization's visibility settings. For example, priority:Urgent,severity:High filters issues where the priority field is Urgent AND the severity field is High.
query.labels string Optional A list of comma separated label names. Example: bug,ui,@high
query.sort string Optional What to sort results by. enum: ["created","updated","comments"]; default: "created"
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.since string Optional Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an issue — github.issues.create

Run Create an issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.title — Required The title of the issue.
body.title string Required oneOf[1]
body.title integer Required oneOf[2]
body.body string Optional The contents of the issue.
body.assignee string | null Optional Login for the user that this issue should be assigned to. NOTE: Only users with push access can set the assignee for new issues. The assignee is silently dropped otherwise. This field is closing down.
body.milestone — Optional
body.milestone string Optional oneOf[1]
body.milestone integer Optional The number of the milestone to associate this issue with. NOTE: Only users with push access can set the milestone for new issues. The milestone is silently dropped otherwise. oneOf[2]
body.labels array Optional Labels to associate with this issue. NOTE: Only users with push access can set labels for new issues. Labels are silently dropped otherwise.
body.labels[] — Optional
body.labels[] string Optional oneOf[1]
body.labels[] object Optional oneOf[2]
body.labels[].id integer Optional oneOf[2]
body.labels[].name string Optional oneOf[2]
body.labels[].description string | null Optional oneOf[2]
body.labels[].color string | null Optional oneOf[2]
body.assignees array Optional Logins for Users to assign to this issue. NOTE: Only users with push access can set assignees for new issues. Assignees are silently dropped otherwise.
body.assignees[] string Optional
body.issue_field_values array Optional An array of issue field values to set on this issue. Each field value must include the field ID and the value to set. Issue fields are only available for organization-owned repositories with the feature enabled. Field values are silently dropped otherwise.
body.issue_field_values[] object Optional additionalProperties: false
body.issue_field_values[].field_id integer Required The ID of the issue field to set
body.issue_field_values[].value — Required The value to set for the field. For multi-select fields, provide an array of option names.
body.issue_field_values[].value string Required oneOf[1]
body.issue_field_values[].value number Required oneOf[2]
body.issue_field_values[].value array Required oneOf[3]
body.issue_field_values[].value[] string Optional oneOf[3]
body.type string | null Optional The name of the issue type to associate with this issue. NOTE: Only users with push access can set the type for new issues. The type is silently dropped otherwise.
body.parent_issue_id integer Optional The id of the parent issue to add this issue to as a sub-issue. NOTE: Only users with triage access to both the parent issue's repository and this repository can set the parent issue.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "title": "Found a bug",
    "body": "I'm having a problem with this.",
    "assignees": [
      "octocat"
    ],
    "milestone": 1,
    "labels": [
      "bug"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List issue comments for a repository — github.issues.list-comments-for-repo

Run List issue comments for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.sort string Optional The property to sort the results by. enum: ["created","updated"]; default: "created"
query.direction string Optional Either asc or desc. Ignored without the sort parameter. enum: ["asc","desc"]
query.since string Optional Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an issue comment — github.issues.get-comment

Run Get an issue comment with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update an issue comment — github.issues.update-comment

Run Update an issue comment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.
body object Required
body.body string Required The contents of the comment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1
  },
  "body": {
    "body": "Me too"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an issue comment — github.issues.delete-comment

Run Delete an issue comment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Pin an issue comment — github.issues.pin-comment

Run Pin an issue comment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Unpin an issue comment — github.issues.unpin-comment

Run Unpin an issue comment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List reactions for an issue comment — github.reactions.list-for-issue-comment

Run List reactions for an issue comment with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.
query object Optional additionalProperties: false
query.content string Optional Returns a single reaction type. Omit this parameter to list all reactions to an issue comment. enum: ["+1","-1","laugh","confused","heart","hooray","rocket","eyes"]
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create reaction for an issue comment — github.reactions.create-for-issue-comment

Run Create reaction for an issue comment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.
body object Required
body.content string Required The reaction type to add to the issue comment. enum: ["+1","-1","laugh","confused","heart","hooray","rocket","eyes"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1
  },
  "body": {
    "content": "heart"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an issue comment reaction — github.reactions.delete-for-issue-comment

Run Delete an issue comment reaction with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.
path.reaction_id integer Required The unique identifier of the reaction.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1,
    "reaction_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List issue events for a repository — github.issues.list-events-for-repo

Run List issue events for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an issue event — github.issues.get-event

Run Get an issue event with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.event_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "event_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an issue — github.issues.get

Run Get an issue with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update an issue — github.issues.update

Run Update an issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
body object Optional
body.title — Optional The title of the issue.
body.title string Optional oneOf[1]
body.title integer Optional oneOf[2]
body.body string | null Optional The contents of the issue.
body.assignee string | null Optional Username to assign to this issue. This field is closing down.
body.state string Optional The open or closed state of the issue. enum: ["open","closed"]
body.state_reason string | null Optional The reason for the state change. Ignored unless state is changed. enum: ["completed","not_planned","duplicate","reopened"]
body.duplicate_issue_id integer Optional The ID of the issue that this issue duplicates, used when marking this issue as a duplicate with status: Duplicate or state_reason: duplicate. The issue must exist and be accessible to the authenticated user.
body.milestone — Optional
body.milestone string Optional oneOf[1]
body.milestone integer Optional The number of the milestone to associate this issue with or use null to remove the current milestone. Only users with push access can set the milestone for issues. Without push access to the repository, milestone changes are silently dropped. oneOf[2]
body.labels array Optional Labels to associate with this issue. Pass one or more labels to replace the set of labels on this issue. Send an empty array ([]) to clear all labels from the issue. Only users with push access can set labels for issues. Without push access to the repository, label changes are silently dropped.
body.labels[] — Optional
body.labels[] string Optional oneOf[1]
body.labels[] object Optional oneOf[2]
body.labels[].id integer Optional oneOf[2]
body.labels[].name string Optional oneOf[2]
body.labels[].description string | null Optional oneOf[2]
body.labels[].color string | null Optional oneOf[2]
body.labels[].rationale string Optional Optional reasoning for selecting this label. oneOf[2]
body.labels[].suggest boolean Optional If true, the change is stored as a pending suggestion for human review rather than applied directly. oneOf[2]
body.labels[].confidence string Optional The confidence level for this label choice. oneOf[2]; enum: ["low","medium","high"]
body.assignees array Optional Usernames to assign to this issue. Pass one or more user logins to replace the set of assignees on this issue. Send an empty array ([]) to clear all assignees from the issue. Only users with push access can set assignees for new issues. Without push access to the repository, assignee changes are silently dropped.
body.assignees[] — Optional
body.assignees[] string Optional oneOf[1]
body.assignees[] object Optional oneOf[2]
body.assignees[].login string Optional oneOf[2]
body.assignees[].rationale string Optional Optional reasoning for selecting this assignee. oneOf[2]
body.assignees[].suggest boolean Optional If true, the change is stored as a pending suggestion for human review rather than applied directly. oneOf[2]
body.assignees[].confidence string Optional The confidence level for this assignee choice. oneOf[2]; enum: ["low","medium","high"]
body.issue_field_values array Optional An array of issue field values to set on this issue. Each field value must include the field ID and the value to set. Only users with push access can set field values for issues
body.issue_field_values[] object Optional additionalProperties: false
body.issue_field_values[].field_id integer Required The ID of the issue field to set
body.issue_field_values[].value — Required The value to set for the field. For multi-select fields, provide an array of option names.
body.issue_field_values[].value string Required oneOf[1]
body.issue_field_values[].value number Required oneOf[2]
body.issue_field_values[].value array Required oneOf[3]
body.issue_field_values[].value[] string Optional oneOf[3]
body.issue_field_values[].rationale string Optional Optional reasoning for setting this field value.
body.issue_field_values[].suggest boolean Optional If true, the change is stored as a pending suggestion for human review rather than applied directly.
body.issue_field_values[].confidence string Optional The confidence level for this field value choice. enum: ["low","medium","high"]
body.type — Optional The issue type to associate with this issue. Only users with push access can set the type for issues. Without push access to the repository, type changes are silently dropped.
body.type string Optional The name of the issue type. oneOf[1]
body.type object Optional The issue type with optional metadata. oneOf[2]
body.type.value string | null Optional The name of the issue type to associate with this issue, or null to remove the current issue type. oneOf[2]
body.type.rationale string Optional Optional reasoning for selecting this type. oneOf[2]
body.type.suggest boolean Optional If true, the change is stored as a pending suggestion for human review rather than applied directly. oneOf[2]
body.type.confidence string Optional The confidence level for this type choice. oneOf[2]; enum: ["low","medium","high"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List issue artifacts — github.issues.list-issue-artifacts

Run List issue artifacts with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
query object Optional additionalProperties: false
query.type string Optional The artifact type to return. enum: ["generic","link","plan","embedded_html"]
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an issue artifact — github.issues.create-issue-artifact

Run Create an issue artifact with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
body object Required
body.type string Optional The artifact type. enum: ["generic","link","plan","embedded_html"]; default: "generic"
body.name string Required The human-readable name of the artifact. minLength: 1
body.body string Required The artifact content. For embedded_html artifacts, provide the HTML source. minLength: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  },
  "body": {
    "type": "generic",
    "name": "Research notes",
    "body": "## Findings\n\nThe API supports issue artifacts."
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an issue artifact — github.issues.get-issue-artifact

Run Get an issue artifact with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
path.artifact_number integer Required The artifact number within the issue.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1,
    "artifact_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update an issue artifact — github.issues.update-issue-artifact

Run Update an issue artifact with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
path.artifact_number integer Required The artifact number within the issue.
body object Required
body.name string Optional The new human-readable name of the artifact. minLength: 1
body.body string Optional The new artifact content. minLength: 1
body — Required anyOf[1]
body — Required anyOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1,
    "artifact_number": 1
  },
  "body": {
    "name": "Revised implementation plan",
    "body": "## Plan\n\nBuild and validate the feature."
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an issue artifact — github.issues.delete-issue-artifact

Run Delete an issue artifact with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
path.artifact_number integer Required The artifact number within the issue.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1,
    "artifact_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add assignees to an issue — github.issues.add-assignees

Run Add assignees to an issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
body object Optional
body.assignees array Optional Usernames of people to assign this issue to. NOTE: Only users with push access can add assignees to an issue. Assignees are silently ignored otherwise.
body.assignees[] — Optional
body.assignees[] string Optional oneOf[1]
body.assignees[] object Optional oneOf[2]
body.assignees[].login string Required The login of the user to assign. oneOf[2]
body.assignees[].rationale string Optional Optional reasoning for adding this assignee. oneOf[2]
body.assignees[].suggest boolean Optional If true, the assignee is stored as a pending suggestion for human review rather than applied directly. oneOf[2]
body.assignees[].confidence string Optional The confidence level for this assignee choice. oneOf[2]; enum: ["low","medium","high"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove assignees from an issue — github.issues.remove-assignees

Run Remove assignees from an issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
body object Optional
body.assignees array Optional Usernames of assignees to remove from an issue. NOTE: Only users with push access can remove assignees from an issue. Assignees are silently ignored otherwise.
body.assignees[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check if a user can be assigned to a issue — github.issues.check-user-can-be-assigned-to-issue

Run Check if a user can be assigned to a issue with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
path.assignee string Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1,
    "assignee": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List issue comments — github.issues.list-comments

Run List issue comments with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
query object Optional additionalProperties: false
query.since string Optional Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create an issue comment — github.issues.create-comment

Run Create an issue comment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
body object Required
body.body string Required The contents of the comment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  },
  "body": {
    "body": "Me too"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List dependencies an issue is blocked by — github.issues.list-dependencies-blocked-by

Run List dependencies an issue is blocked by with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add a dependency an issue is blocked by — github.issues.add-blocked-by-dependency

Run Add a dependency an issue is blocked by with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
body object Required
body.issue_id integer Required The id of the issue that blocks the current issue

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  },
  "body": {
    "issue_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove dependency an issue is blocked by — github.issues.remove-dependency-blocked-by

Run Remove dependency an issue is blocked by with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
path.issue_id integer Required The id of the blocking issue to remove as a dependency

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1,
    "issue_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List dependencies an issue is blocking — github.issues.list-dependencies-blocking

Run List dependencies an issue is blocking with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List issue events — github.issues.list-events

Run List issue events with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List issue field values for an issue — github.issues.list-issue-field-values-for-issue

Run List issue field values for an issue with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add issue field values to an issue — github.issues.add-issue-field-values

Run Add issue field values to an issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
body object Required
body.issue_field_values array Optional An array of issue field values to add to this issue. Each field value must include the field ID and the value to set. maxItems: 25
body.issue_field_values[] object Optional additionalProperties: false
body.issue_field_values[].field_id integer Required The ID of the issue field to set
body.issue_field_values[].value — Required The value to set for the field. The type depends on the field's data type: - For text fields: provide a string value - For single_select fields: provide the option name as a string (must match an existing option) - For number fields: provide a numeric value - For multi_select fields: provide an array of option names (must match existing options) - For date fields: provide an ISO 8601 date string
body.issue_field_values[].value string Required The value to set for text, single_select, or date fields oneOf[1]
body.issue_field_values[].value number Required The value to set for number fields oneOf[2]
body.issue_field_values[].value array Required The value to set for multi_select fields (array of option names) oneOf[3]
body.issue_field_values[].value[] string Optional oneOf[3]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  },
  "body": {
    "issue_field_values": [
      {
        "field_id": 123,
        "value": "Critical"
      },
      {
        "field_id": 456,
        "value": 5
      },
      {
        "field_id": 789,
        "value": "2024-12-31"
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set issue field values for an issue — github.issues.set-issue-field-values

Run Set issue field values for an issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
body object Required
body.issue_field_values array Optional An array of issue field values to set for this issue. Each field value must include the field ID and the value to set. All existing field values will be replaced. maxItems: 25
body.issue_field_values[] object Optional additionalProperties: false
body.issue_field_values[].field_id integer Required The ID of the issue field to set
body.issue_field_values[].value — Required The value to set for the field. The type depends on the field's data type: - For text fields: provide a string value - For single_select fields: provide the option name as a string (must match an existing option) - For number fields: provide a numeric value - For date fields: provide an ISO 8601 date string
body.issue_field_values[].value string Required The value to set for text, single_select, or date fields oneOf[1]
body.issue_field_values[].value number Required The value to set for number fields oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  },
  "body": {
    "issue_field_values": [
      {
        "field_id": 123,
        "value": "Critical"
      },
      {
        "field_id": 456,
        "value": 5
      },
      {
        "field_id": 789,
        "value": "2024-12-31"
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an issue field value from an issue — github.issues.delete-issue-field-value

Run Delete an issue field value from an issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
path.issue_field_id integer Required The unique identifier of the issue field.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1,
    "issue_field_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List labels for an issue — github.issues.list-labels-on-issue

Run List labels for an issue with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add labels to an issue — github.issues.add-labels

Run Add labels to an issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
body — Optional
body object Optional oneOf[1]
body.labels array Optional The labels to add to the issue's existing labels. You can also pass an array of labels directly, but GitHub recommends passing an object with the labels key. To replace all of the labels for an issue, use "Set labels for an issue." oneOf[1]; minItems: 1
body.labels[] — Optional oneOf[1]
body.labels[] string Optional oneOf[1]; oneOf[1]
body.labels[] object Optional oneOf[1]; oneOf[2]
body.labels[].name string Required The name of the label to add. oneOf[1]; oneOf[2]
body.labels[].rationale string Optional Optional reasoning for adding this label. oneOf[1]; oneOf[2]
body.labels[].suggest boolean Optional If true, the label is stored as a pending suggestion for human review rather than applied directly. oneOf[1]; oneOf[2]
body.labels[].confidence string Optional The confidence level for this label choice. oneOf[1]; oneOf[2]; enum: ["low","medium","high"]
body array Optional oneOf[2]
body[] string Optional oneOf[2]
body array Optional oneOf[3]
body[] object Optional oneOf[3]
body[].name string Required oneOf[3]
body[].rationale string Optional Optional reasoning for adding this label. oneOf[3]
body[].suggest boolean Optional If true, the label is stored as a pending suggestion for human review rather than applied directly. oneOf[3]
body[].confidence string Optional The confidence level for this label choice. oneOf[3]; enum: ["low","medium","high"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set labels for an issue — github.issues.set-labels

Run Set labels for an issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
body — Optional
body object Optional oneOf[1]
body.labels array Optional The names of the labels to set for the issue. The labels you set replace any existing labels. You can pass an empty array to remove all labels. Alternatively, you can pass a single label as a string or an array of labels directly, but GitHub recommends passing an object with the labels key. You can also add labels to the existing labels for an issue. For more information, see "Add labels to an issue." oneOf[1]; minItems: 1
body.labels[] string Optional oneOf[1]
body array Optional oneOf[2]; minItems: 1
body[] string Optional oneOf[2]
body object Optional oneOf[3]
body.labels array Optional oneOf[3]; minItems: 1
body.labels[] object Optional oneOf[3]
body.labels[].name string Required oneOf[3]
body array Optional oneOf[4]; minItems: 1
body[] object Optional oneOf[4]
body[].name string Required oneOf[4]
body string Optional oneOf[5]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove all labels from an issue — github.issues.remove-all-labels

Run Remove all labels from an issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove a label from an issue — github.issues.remove-label

Run Remove a label from an issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
path.name string Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1,
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Lock an issue — github.issues.lock

Run Lock an issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
body object | null Optional
body.lock_reason string Optional The reason for locking the issue or pull request conversation. Lock will fail if you don't use one of these reasons: * off-topic * too heated * resolved * spam enum: ["off-topic","too heated","resolved","spam"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Unlock an issue — github.issues.unlock

Run Unlock an issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get parent issue — github.issues.get-parent

Run Get parent issue with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List reactions for an issue — github.reactions.list-for-issue

Run List reactions for an issue with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
query object Optional additionalProperties: false
query.content string Optional Returns a single reaction type. Omit this parameter to list all reactions to an issue. enum: ["+1","-1","laugh","confused","heart","hooray","rocket","eyes"]
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create reaction for an issue — github.reactions.create-for-issue

Run Create reaction for an issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
body object Required
body.content string Required The reaction type to add to the issue. enum: ["+1","-1","laugh","confused","heart","hooray","rocket","eyes"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  },
  "body": {
    "content": "heart"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an issue reaction — github.reactions.delete-for-issue

Run Delete an issue reaction with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
path.reaction_id integer Required The unique identifier of the reaction.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1,
    "reaction_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List issues related to an issue — github.issues.list-relates-to

Run List issues related to an issue with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add a related issue — github.issues.add-relates-to

Run Add a related issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
body object Required
body.issue_id integer Required The id of the issue to mark as related to the current issue

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  },
  "body": {
    "issue_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove a related issue — github.issues.remove-relates-to

Run Remove a related issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
path.issue_id integer Required The id of the related issue to remove

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1,
    "issue_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove sub-issue — github.issues.remove-sub-issue

Run Remove sub-issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
body object Required
body.sub_issue_id integer Required The id of the sub-issue to remove

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  },
  "body": {
    "sub_issue_id": 6
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List sub-issues — github.issues.list-sub-issues

Run List sub-issues with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add sub-issue — github.issues.add-sub-issue

Run Add sub-issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
body object Required
body.sub_issue_id integer Required The id of the sub-issue to add. The sub-issue must belong to the same repository owner as the parent issue
body.replace_parent boolean Optional Option that, when true, instructs the operation to replace the sub-issues current parent issue

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  },
  "body": {
    "sub_issue_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Reprioritize sub-issue — github.issues.reprioritize-sub-issue

Run Reprioritize sub-issue with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
body object Required
body.sub_issue_id integer Required The id of the sub-issue to reprioritize
body.after_id integer Optional The id of the sub-issue to be prioritized after (either positional argument after OR before should be specified).
body.before_id integer Optional The id of the sub-issue to be prioritized before (either positional argument after OR before should be specified).

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  },
  "body": {
    "sub_issue_id": 6,
    "after_id": 5
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List issue suggestions — github.issues.list-suggestions

Run List issue suggestions with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
query object Optional additionalProperties: false
query.state string Optional Filter suggestions by their state. enum: ["pending","applied","approved","dismissed","replaced","invalidated","all"]; default: "pending"
query.action string Optional Filter suggestions by the change they propose. enum: ["set_type","add_label","add_field","add_assignee","close_issue"]
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Approve an issue suggestion — github.issues.approve-suggestion

Run Approve an issue suggestion with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
path.suggestion_id integer Required The unique identifier of the suggestion.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1,
    "suggestion_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Dismiss an issue suggestion — github.issues.dismiss-suggestion

Run Dismiss an issue suggestion with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
path.suggestion_id integer Required The unique identifier of the suggestion.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1,
    "suggestion_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List timeline events for an issue — github.issues.list-events-for-timeline

Run List timeline events for an issue with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.issue_number integer Required The number that identifies the issue.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.exclude string Optional A comma-separated list of timeline event names to exclude from the response.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "issue_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List deploy keys — github.repos.list-deploy-keys

Run List deploy keys with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a deploy key — github.repos.create-deploy-key

Run Create a deploy key with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.title string Optional A name for the key.
body.key string Required The contents of the key.
body.read_only boolean Optional If true, the key will only be able to read repository contents. Otherwise, the key will be able to read and write. Deploy keys with write access can perform the same actions as an organization member with admin access, or a collaborator on a personal repository. For more information, see "Repository permission levels for an organization" and "Permission levels for a user account repository."

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "title": "octocat@octomac",
    "key": "ssh-rsa AAA...",
    "read_only": true
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a deploy key — github.repos.get-deploy-key

Run Get a deploy key with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.key_id integer Required The unique identifier of the key.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "key_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a deploy key — github.repos.delete-deploy-key

Run Delete a deploy key with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.key_id integer Required The unique identifier of the key.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "key_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List labels for a repository — github.issues.list-labels-for-repo

Run List labels for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a label — github.issues.create-label

Run Create a label with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.name string Required The name of the label. Emoji can be added to label names, using either native emoji or colon-style markup. For example, typing :strawberry: will render the emoji :strawberry:. For a full list of available emoji and codes, see "Emoji cheat sheet."
body.color string Optional The hexadecimal color code for the label, without the leading #.
body.description string Optional A short description of the label. Must be 100 characters or fewer.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "name": "bug",
    "description": "Something isn't working",
    "color": "f29513"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a label — github.issues.get-label

Run Get a label with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.name string Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a label — github.issues.update-label

Run Update a label with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.name string Required
body object Optional
body.new_name string Optional The new name of the label. Emoji can be added to label names, using either native emoji or colon-style markup. For example, typing :strawberry: will render the emoji :strawberry:. For a full list of available emoji and codes, see "Emoji cheat sheet."
body.color string Optional The hexadecimal color code for the label, without the leading #.
body.description string Optional A short description of the label. Must be 100 characters or fewer.
body.archived boolean Optional Whether to archive or unarchive the label. Archived labels cannot be added to issues or pull requests. For more information, see "Archiving labels."

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a label — github.issues.delete-label

Run Delete a label with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.name string Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository languages — github.repos.list-languages

Run List repository languages with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the license for a repository — github.licenses.get-for-repo

Run Get the license for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.ref — Optional The Git reference for the results you want to list. The ref for a branch can be formatted either as refs/heads/<branch name> or simply <branch name>. To reference a pull request use refs/pull/<number>/merge. $ref: "#/definitions/code-scanning-ref"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Sync a fork branch with the upstream repository — github.repos.merge-upstream

Run Sync a fork branch with the upstream repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.branch string Required The name of the branch which should be updated to match upstream.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "branch": "main"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Merge a branch — github.repos.merge

Run Merge a branch with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.base string Required The name of the base branch that the head will be merged into.
body.head string Required The head to merge. This can be a branch name or a commit SHA1.
body.commit_message string Optional Commit message to use for the merge commit. If omitted, a default message will be used.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "base": "master",
    "head": "cool_feature",
    "commit_message": "Shipped cool_feature!"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List milestones — github.issues.list-milestones

Run List milestones with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.state string Optional The state of the milestone. Either open, closed, or all. enum: ["open","closed","all"]; default: "open"
query.sort string Optional What to sort results by. Either due_on or completeness. enum: ["due_on","completeness"]; default: "due_on"
query.direction string Optional The direction of the sort. Either asc or desc. enum: ["asc","desc"]; default: "asc"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a milestone — github.issues.create-milestone

Run Create a milestone with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.title string Required The title of the milestone.
body.state string Optional The state of the milestone. Either open or closed. enum: ["open","closed"]; default: "open"
body.description string Optional A description of the milestone.
body.due_on string Optional The milestone due date. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "title": "v1.0",
    "state": "open",
    "description": "Tracking milestone for version 1.0",
    "due_on": "2012-10-09T23:39:01Z"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a milestone — github.issues.get-milestone

Run Get a milestone with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.milestone_number integer Required The number that identifies the milestone.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "milestone_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a milestone — github.issues.update-milestone

Run Update a milestone with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.milestone_number integer Required The number that identifies the milestone.
body object Optional
body.title string Optional The title of the milestone.
body.state string Optional The state of the milestone. Either open or closed. enum: ["open","closed"]; default: "open"
body.description string Optional A description of the milestone.
body.due_on string Optional The milestone due date. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "milestone_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a milestone — github.issues.delete-milestone

Run Delete a milestone with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.milestone_number integer Required The number that identifies the milestone.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "milestone_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List labels for issues in a milestone — github.issues.list-labels-for-milestone

Run List labels for issues in a milestone with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.milestone_number integer Required The number that identifies the milestone.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "milestone_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository notifications for the authenticated user — github.activity.list-repo-notifications-for-authenticated-user

Run List repository notifications for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.all boolean Optional If true, show notifications marked as read. default: false
query.participating boolean Optional If true, only shows notifications in which the user is directly participating or mentioned. default: false
query.since string Optional Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.before string Optional Only show notifications updated before the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Mark repository notifications as read — github.activity.mark-repo-notifications-as-read

Run Mark repository notifications as read with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Optional
body.last_read_at string Optional Describes the last point that notifications were checked. Anything updated since this time will not be marked as read. If you omit this parameter, all notifications are marked as read. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. Default: The current timestamp. format: "date-time"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a GitHub Pages site — github.repos.get-pages

Run Get a GitHub Pages site with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a GitHub Pages site — github.repos.create-pages-site

Run Create a GitHub Pages site with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object | null Required The source branch and directory used to publish your Pages site.
body.build_type string Optional The process in which the Page will be built. Possible values are "legacy" and "workflow". enum: ["legacy","workflow"]
body.source object Optional The source branch and directory used to publish your Pages site.
body.source.branch string Required The repository branch used to publish your site's source files.
body.source.path string Optional The repository directory that includes the source files for the Pages site. Allowed paths are / or /docs. Default: / enum: ["/","/docs"]; default: "/"
body — Required anyOf[1]
body — Required anyOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "source": {
      "branch": "main",
      "path": "/docs"
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update information about a GitHub Pages site — github.repos.update-information-about-pages-site

Run Update information about a GitHub Pages site with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.cname string | null Optional Specify a custom domain for the repository. Sending a null value will remove the custom domain. For more about custom domains, see "Using a custom domain with GitHub Pages."
body.https_enforced boolean Optional Specify whether HTTPS should be enforced for the repository.
body.build_type string Optional The process by which the GitHub Pages site will be built. workflow means that the site is built by a custom GitHub Actions workflow. legacy means that the site is built by GitHub when changes are pushed to a specific branch. enum: ["legacy","workflow"]
body.source — Optional
body.source string Optional Update the source for the repository. Must include the branch name, and may optionally specify the subdirectory /docs. Possible values are "gh-pages", "master", and "master /docs". anyOf[1]; enum: ["gh-pages","master","master /docs"]
body.source object Optional Update the source for the repository. Must include the branch name and path. anyOf[2]
body.source.branch string Required The repository branch used to publish your site's source files. anyOf[2]
body.source.path string Required The repository directory that includes the source files for the Pages site. Allowed paths are / or /docs. anyOf[2]; enum: ["/","/docs"]
body — Required anyOf[1]
body — Required anyOf[2]
body — Required anyOf[3]
body — Required anyOf[4]
body — Required anyOf[5]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "cname": "octocatblog.com",
    "source": {
      "branch": "main",
      "path": "/"
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a GitHub Pages site — github.repos.delete-pages-site

Run Delete a GitHub Pages site with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List GitHub Pages builds — github.repos.list-pages-builds

Run List GitHub Pages builds with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Request a GitHub Pages build — github.repos.request-pages-build

Run Request a GitHub Pages build with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get latest Pages build — github.repos.get-latest-pages-build

Run Get latest Pages build with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get GitHub Pages build — github.repos.get-pages-build

Run Get GitHub Pages build with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.build_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "build_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a GitHub Pages deployment — github.repos.create-pages-deployment

Run Create a GitHub Pages deployment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required The object used to create GitHub Pages deployment
body.artifact_id number Optional The ID of an artifact that contains the .zip or .tar of static assets to deploy. The artifact belongs to the repository. Either artifact_id or artifact_url are required.
body.artifact_url string Optional The URL of an artifact that contains the .zip or .tar of static assets to deploy. The artifact belongs to the repository. Either artifact_id or artifact_url are required.
body.environment string Optional The target environment for this GitHub Pages deployment. default: "github-pages"
body.pages_build_version string Required A unique string that represents the version of the build for this deployment. default: "GITHUB_SHA"
body.oidc_token string Required The OIDC token issued by GitHub Actions certifying the origin of the deployment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "artifact_url": "https://example.com/",
    "environment": "github-pages",
    "pages_build_version": "4fd754f7e594640989b406850d0bc8f06a121251",
    "oidc_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIng1dCI6IlV2R1h4SUhlY0JFc1JCdEttemUxUEhfUERiVSIsImtpZCI6IjUyRjE5N0M0ODFERTcwMTEyQzQ0MUI0QTlCMzdCNTNDN0ZDRjBEQjUifQ.eyJqdGkiOiJhMWIwNGNjNy0zNzZiLTQ1N2QtOTMzNS05NTY5YmVjZDExYTIiLCJzdWIiOiJyZXBvOnBhcGVyLXNwYS9taW55aTplbnZpcm9ubWVudDpQcm9kdWN0aW9uIiwiYXVkIjoiaHR0cHM6Ly9naXRodWIuY29tL3BhcGVyLXNwYSIsInJlZiI6InJlZnMvaGVhZHMvbWFpbiIsInNoYSI6ImEyODU1MWJmODdiZDk3NTFiMzdiMmM0YjM3M2MxZjU3NjFmYWM2MjYiLCJyZXBvc2l0b3J5IjoicGFwZXItc3BhL21pbnlpIiwicmVwb3NpdG9yeV9vd25lciI6InBhcGVyLXNwYSIsInJ1bl9pZCI6IjE1NDY0NTkzNjQiLCJydW5fbnVtYmVyIjoiMzQiLCJydW5fYXR0ZW1wdCI6IjYiLCJhY3RvciI6IllpTXlzdHkiLCJ3b3JrZmxvdyI6IkNJIiwiaGVhZF9yZWYiOiIiLCJiYXNlX3JlZiI6IiIsImV2ZW50X25hbWUiOiJwdXNoIiwicmVmX3R5cGUiOiJicmFuY2giLCJlbnZpcm9ubWVudCI6IlByb2R1Y3Rpb24iLCJqb2Jfd29ya2Zsb3dfcmVmIjoicGFwZXItc3BhL21pbnlpLy5naXRodWIvd29ya2Zsb3dzL2JsYW5rLnltbEByZWZzL2hlYWRzL21haW4iLCJpc3MiOiJodHRwczovL3Rva2VuLmFjdGlvbnMuZ2l0aHVidXNlcmNvbnRlbnQuY29tIiwibmJmIjoxNjM5MDAwODU2LCJleHAiOjE2MzkwMDE3NTYsImlhdCI6MTYzOTAwMTQ1Nn0.VP8WictbQECKozE2SgvKb2FqJ9hisWsoMkYRTqfBrQfZTCXi5IcFEdgDMB2X7a99C2DeUuTvHh9RMKXLL2a0zg3-Sd7YrO7a2ll2kNlnvyIypcN6AeIc7BxHsTTnZN9Ud_xmEsTrSRGOEKmzCFkULQ6N4zlVD0sidypmXlMemmWEcv_ZHqhioEI_VMp5vwXQurketWH7qX4oDgG4okyYtPrv5RQHbfQcVo9izaPJ_jnsDd0CBA0QOx9InjPidtIkMYQLyUgJy33HLJy86EFNUnAf8UhBQuQi5mAsEpEzBBuKpG3PDiPtYCHOk64JZkZGd5mR888a5sbHRiaF8hm8YA"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the status of a GitHub Pages deployment — github.repos.get-pages-deployment

Run Get the status of a GitHub Pages deployment with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pages_deployment_id — Required The ID of the Pages deployment. You can also give the commit SHA of the deployment.
path.pages_deployment_id integer Required oneOf[1]
path.pages_deployment_id string Required oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pages_deployment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Cancel a GitHub Pages deployment — github.repos.cancel-pages-deployment

Run Cancel a GitHub Pages deployment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pages_deployment_id — Required The ID of the Pages deployment. You can also give the commit SHA of the deployment.
path.pages_deployment_id integer Required oneOf[1]
path.pages_deployment_id string Required oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pages_deployment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a DNS health check for GitHub Pages — github.repos.get-pages-health-check

Run Get a DNS health check for GitHub Pages with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check if private vulnerability reporting is enabled for a repository — github.repos.check-private-vulnerability-reporting

Run Check if private vulnerability reporting is enabled for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Enable private vulnerability reporting for a repository — github.repos.enable-private-vulnerability-reporting

Run Enable private vulnerability reporting for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Disable private vulnerability reporting for a repository — github.repos.disable-private-vulnerability-reporting

Run Disable private vulnerability reporting for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get all custom property values for a repository — github.repos.custom-properties-for-repos-get-repository-values

Run Get all custom property values for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update custom property values for a repository — github.repos.custom-properties-for-repos-create-or-update-repository-values

Run Create or update custom property values for a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.properties array Required A list of custom property names and associated values to apply to the repositories.
body.properties[] — Optional $ref: "#/definitions/custom-property-value"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "properties": []
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List pull requests — github.pulls.list

Run List pull requests with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.state string Optional Either open, closed, or all to filter by state. enum: ["open","closed","all"]; default: "open"
query.head string Optional Filter pulls by head user or head organization and branch name in the format of user:ref-name or organization:ref-name. For example: github:new-script-format or octocat:test-branch.
query.base string Optional Filter pulls by base branch name. Example: gh-pages.
query.sort string Optional What to sort results by. popularity will sort by the number of comments. long-running will sort by date created and will limit the results to pull requests that have been open for more than a month and have had activity within the past month. enum: ["created","updated","popularity","long-running"]; default: "created"
query.direction string Optional The direction of the sort. Default: desc when sort is created or sort is not specified, otherwise asc. enum: ["asc","desc"]
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a pull request — github.pulls.create

Run Create a pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.title string Optional The title of the new pull request. Required unless issue is specified.
body.head string Required The name of the branch where your changes are implemented. For cross-repository pull requests in the same network, namespace head with a user like this: username:branch.
body.head_repo string Optional The name of the repository where the changes in the pull request were made. This field is required for cross-repository pull requests if both repositories are owned by the same organization.
body.base string Required The name of the branch you want the changes pulled into. This should be an existing branch on the current repository. You cannot submit a pull request to one repository that requests a merge to a base of another repository.
body.body string Optional The contents of the pull request.
body.maintainer_can_modify boolean Optional Indicates whether maintainers can modify the pull request.
body.draft boolean Optional Indicates whether the pull request is a draft. See "Draft Pull Requests" in the GitHub Help documentation to learn more.
body.issue integer Optional An issue in the repository to convert to a pull request. The issue title, body, and comments will become the title, body, and comments on the new pull request. Required unless title is specified.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "title": "Amazing new feature",
    "body": "Please pull these awesome changes in!",
    "head": "octocat:new-feature",
    "base": "master"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List review comments in a repository — github.pulls.list-review-comments-for-repo

Run List review comments in a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.sort string Optional enum: ["created","updated","created_at"]
query.direction string Optional The direction to sort results. Ignored without sort parameter. enum: ["asc","desc"]
query.since string Optional Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a review comment for a pull request — github.pulls.get-review-comment

Run Get a review comment for a pull request with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a review comment for a pull request — github.pulls.update-review-comment

Run Update a review comment for a pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.
body object Required
body.body string Required The text of the reply to the review comment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1
  },
  "body": {
    "body": "I like this too!"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a review comment for a pull request — github.pulls.delete-review-comment

Run Delete a review comment for a pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List reactions for a pull request review comment — github.reactions.list-for-pull-request-review-comment

Run List reactions for a pull request review comment with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.
query object Optional additionalProperties: false
query.content string Optional Returns a single reaction type. Omit this parameter to list all reactions to a pull request review comment. enum: ["+1","-1","laugh","confused","heart","hooray","rocket","eyes"]
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create reaction for a pull request review comment — github.reactions.create-for-pull-request-review-comment

Run Create reaction for a pull request review comment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.
body object Required
body.content string Required The reaction type to add to the pull request review comment. enum: ["+1","-1","laugh","confused","heart","hooray","rocket","eyes"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1
  },
  "body": {
    "content": "heart"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a pull request comment reaction — github.reactions.delete-for-pull-request-comment

Run Delete a pull request comment reaction with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.comment_id integer Required The unique identifier of the comment.
path.reaction_id integer Required The unique identifier of the reaction.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "comment_id": 1,
    "reaction_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a pull request — github.pulls.get

Run Get a pull request with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a pull request — github.pulls.update

Run Update a pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
body object Optional
body.title string Optional The title of the pull request.
body.body string Optional The contents of the pull request.
body.state string Optional State of this Pull Request. Either open or closed. enum: ["open","closed"]
body.base string Optional The name of the branch you want your changes pulled into. This should be an existing branch on the current repository. You cannot update the base branch on a pull request to point to another repository.
body.maintainer_can_modify boolean Optional Indicates whether maintainers can modify the pull request.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a codespace from a pull request — github.codespaces.create-with-pr-for-authenticated-user

Run Create a codespace from a pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
body object | null Required
body.location string Optional The requested location for a new codespace. Best efforts are made to respect this upon creation. Assigned by IP if not provided.
body.geo string Optional The geographic area for this codespace. If not specified, the value is assigned by IP. This property replaces location, which is closing down. enum: ["EuropeWest","SoutheastAsia","UsEast","UsWest"]
body.client_ip string Optional IP for location auto-detection when proxying a request
body.machine string Optional Machine type to use for this codespace
body.devcontainer_path string Optional Path to devcontainer.json config to use for this codespace
body.multi_repo_permissions_opt_out boolean Optional Whether to authorize requested permissions from devcontainer.json
body.working_directory string Optional Working directory for this codespace
body.idle_timeout_minutes integer Optional Time in minutes before codespace stops from inactivity
body.display_name string Optional Display name for this codespace
body.retention_period_minutes integer Optional Duration in minutes after codespace has gone idle in which it will be deleted. Must be integer minutes between 0 and 43200 (30 days).

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1
  },
  "body": {
    "repository_id": 1,
    "ref": "main"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List review comments on a pull request — github.pulls.list-review-comments

Run List review comments on a pull request with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
query object Optional additionalProperties: false
query.sort string Optional The property to sort the results by. enum: ["created","updated"]; default: "created"
query.direction string Optional The direction to sort results. Ignored without sort parameter. enum: ["asc","desc"]
query.since string Optional Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a review comment for a pull request — github.pulls.create-review-comment

Run Create a review comment for a pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
body object Required
body.body string Required The text of the review comment.
body.commit_id string Required The SHA of the commit needing a comment. Not using the latest commit SHA may render your comment outdated if a subsequent commit modifies the line you specify as the position.
body.path string Required The relative path to the file that necessitates a comment.
body.position integer Optional This parameter is closing down. Use line instead. The position in the diff where you want to add a review comment. Note this value is not the same as the line number in the file. The position value equals the number of lines down from the first "@@" hunk header in the file you want to add a comment. The line just below the "@@" line is position 1, the next line is position 2, and so on. The position in the diff continues to increase through lines of whitespace and additional hunks until the beginning of a new file.
body.side string Optional In a split diff view, the side of the diff that the pull request's changes appear on. Can be LEFT or RIGHT. Use LEFT for deletions that appear in red. Use RIGHT for additions that appear in green or unchanged lines that appear in white and are shown for context. For a multi-line comment, side represents whether the last line of the comment range is a deletion or addition. For more information, see "Diff view options" in the GitHub Help documentation. enum: ["LEFT","RIGHT"]
body.line integer Optional Required unless using subject_type:file. The line of the blob in the pull request diff that the comment applies to. For a multi-line comment, the last line of the range that your comment applies to.
body.start_line integer Optional Required when using multi-line comments unless using in_reply_to. The start_line is the first line in the pull request diff that your multi-line comment applies to. To learn more about multi-line comments, see "Commenting on a pull request" in the GitHub Help documentation.
body.start_side string Optional Required when using multi-line comments unless using in_reply_to. The start_side is the starting side of the diff that the comment applies to. Can be LEFT or RIGHT. To learn more about multi-line comments, see "Commenting on a pull request" in the GitHub Help documentation. See side in this table for additional context. enum: ["LEFT","RIGHT","side"]
body.in_reply_to integer Optional The ID of the review comment to reply to. To find the ID of a review comment with "List review comments on a pull request". When specified, all parameters other than body in the request body are ignored.
body.subject_type string Optional The level at which the comment is targeted. enum: ["line","file"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1
  },
  "body": {
    "body": "Great stuff!",
    "commit_id": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
    "path": "file1.txt",
    "start_line": 1,
    "start_side": "RIGHT",
    "line": 2,
    "side": "RIGHT"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a reply for a review comment — github.pulls.create-reply-for-review-comment

Run Create a reply for a review comment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
path.comment_id integer Required The unique identifier of the comment.
body object Required
body.body string Required The text of the review comment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1,
    "comment_id": 1
  },
  "body": {
    "body": "Great stuff!"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List commits on a pull request — github.pulls.list-commits

Run List commits on a pull request with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List pull requests files — github.pulls.list-files

Run List pull requests files with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check if a pull request has been merged — github.pulls.check-if-merged

Run Check if a pull request has been merged with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Merge a pull request — github.pulls.merge

Run Merge a pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
body object | null Optional
body.commit_title string Optional Title for the automatic commit message.
body.commit_message string Optional Extra detail to append to automatic commit message.
body.sha string Optional SHA that pull request head must match to allow merge.
body.merge_method string Optional The merge method to use. enum: ["merge","squash","rebase"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Merge a pull request asynchronously — github.pulls.merge-async

Run Merge a pull request asynchronously with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
body object | null Optional
body.commit_title string Optional Title for the automatic commit message. Only supported for direct merges.
body.commit_message string Optional Extra detail to append to automatic commit message. Only supported for direct merges.
body.sha string Optional SHA that pull request head must match to allow merge. If not provided, the current head of the PR at the time of the request will be used; if the PR is pushed in between the merge being requested and being executed, the merge will be cancelled.
body.merge_method string Optional The merge method to use for a direct merge. Only supported for direct merges. enum: ["merge","squash","rebase"]
body.merge_action string Optional The action that will be taken to merge the pull request. direct_merge merges the pull request directly without using a merge queue; merge_queue adds the pull request to a merge queue; default uses a merge queue if one is configured for the target branch, or merges directly otherwise. If omitted, defaults to default. enum: ["default","direct_merge","merge_queue"]
body.bypass_rules boolean Optional Whether to bypass repository rules that the authenticated actor is permitted to bypass. default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the result of an asynchronous merge — github.pulls.get-merge-async-result

Run Get the result of an asynchronous merge with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
path.uuid string Required The UUID of the asynchronous merge request, as returned when the merge was requested.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1,
    "uuid": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get all requested reviewers for a pull request — github.pulls.list-requested-reviewers

Run Get all requested reviewers for a pull request with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Request reviewers for a pull request — github.pulls.request-reviewers

Run Request reviewers for a pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
body object Optional
body.reviewers array Optional An array of user logins that will be requested.
body.reviewers[] string Optional
body.team_reviewers array Optional An array of team slugs that will be requested.
body.team_reviewers[] string Optional
body — Optional anyOf[1]
body — Optional anyOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove requested reviewers from a pull request — github.pulls.remove-requested-reviewers

Run Remove requested reviewers from a pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
body object Required
body.reviewers array Required An array of user logins that will be removed.
body.reviewers[] string Optional
body.team_reviewers array Optional An array of team slugs that will be removed.
body.team_reviewers[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1
  },
  "body": {
    "reviewers": [
      "octocat",
      "hubot",
      "other_user"
    ],
    "team_reviewers": [
      "justice-league"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Rerequest reviewers for a pull request — github.pulls.rerequest-reviewers

Run Rerequest reviewers for a pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
body object Optional
body.reviewers array Optional An array of user logins whose reviews will be rerequested.
body.reviewers[] string Optional
body.team_reviewers array Optional An array of team slugs whose reviews will be rerequested.
body.team_reviewers[] string Optional
body — Optional anyOf[1]
body — Optional anyOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List reviews for a pull request — github.pulls.list-reviews

Run List reviews for a pull request with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a review for a pull request — github.pulls.create-review

Run Create a review for a pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
body object Optional
body.commit_id string Optional The SHA of the commit that needs a review. Not using the latest commit SHA may render your review comment outdated if a subsequent commit modifies the line you specify as the position. Defaults to the most recent commit in the pull request when you do not specify a value.
body.body string Optional Required when using REQUEST_CHANGES or COMMENT for the event parameter. The body text of the pull request review.
body.event string Optional The review action you want to perform. The review actions include: APPROVE, REQUEST_CHANGES, or COMMENT. By leaving this blank, you set the review action state to PENDING, which means you will need to submit the pull request review when you are ready. enum: ["APPROVE","REQUEST_CHANGES","COMMENT"]
body.comments array Optional Use the following table to specify the location, destination, and contents of the draft review comment.
body.comments[] object Optional
body.comments[].path string Required The relative path to the file that necessitates a review comment.
body.comments[].position integer Optional The position in the diff where you want to add a review comment. Note this value is not the same as the line number in the file. The position value equals the number of lines down from the first "@@" hunk header in the file you want to add a comment. The line just below the "@@" line is position 1, the next line is position 2, and so on. The position in the diff continues to increase through lines of whitespace and additional hunks until the beginning of a new file.
body.comments[].body string Required Text of the review comment.
body.comments[].line integer Optional
body.comments[].side string Optional
body.comments[].start_line integer Optional
body.comments[].start_side string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a review for a pull request — github.pulls.get-review

Run Get a review for a pull request with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
path.review_id integer Required The unique identifier of the review.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1,
    "review_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a review for a pull request — github.pulls.update-review

Run Update a review for a pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
path.review_id integer Required The unique identifier of the review.
body object Required
body.body string Required The body text of the pull request review.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1,
    "review_id": 1
  },
  "body": {
    "body": "This is close to perfect! Please address the suggested inline change. And add more about this."
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a pending review for a pull request — github.pulls.delete-pending-review

Run Delete a pending review for a pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
path.review_id integer Required The unique identifier of the review.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1,
    "review_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List comments for a pull request review — github.pulls.list-comments-for-review

Run List comments for a pull request review with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
path.review_id integer Required The unique identifier of the review.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1,
    "review_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Dismiss a review for a pull request — github.pulls.dismiss-review

Run Dismiss a review for a pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
path.review_id integer Required The unique identifier of the review.
body object Required
body.message string Required The message for the pull request review dismissal
body.event string Optional enum: ["DISMISS"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1,
    "review_id": 1
  },
  "body": {
    "message": "You are dismissed",
    "event": "DISMISS"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Submit a review for a pull request — github.pulls.submit-review

Run Submit a review for a pull request with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
path.review_id integer Required The unique identifier of the review.
body object Required
body.body string Optional The body text of the pull request review
body.event string Required The review action you want to perform. The review actions include: APPROVE, REQUEST_CHANGES, or COMMENT. When you leave this blank, the API returns HTTP 422 (Unrecognizable entity) and sets the review action state to PENDING, which means you will need to re-submit the pull request review using a review action. enum: ["APPROVE","REQUEST_CHANGES","COMMENT"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1,
    "review_id": 1
  },
  "body": {
    "body": "Here is the body for the review.",
    "event": "REQUEST_CHANGES"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a pull request branch — github.pulls.update-branch

Run Update a pull request branch with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pull_number integer Required The number that identifies the pull request.
body object | null Optional
body.expected_head_sha string Optional The expected SHA of the pull request's HEAD ref. This is the most recent commit on the pull request's branch. If the expected SHA does not match the pull request's HEAD, you will receive a 422 Unprocessable Entity status. You can use the "List commits" endpoint to find the most recent commit SHA. Default: SHA of the pull request's current HEAD ref.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pull_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository README — github.repos.get-readme

Run Get a repository README with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.ref string Optional The name of the commit/branch/tag. Default: the repository’s default branch.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository README for a directory — github.repos.get-readme-in-directory

Run Get a repository README for a directory with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.dir string Required The alternate path to look for a README file
query object Optional additionalProperties: false
query.ref string Optional The name of the commit/branch/tag. Default: the repository’s default branch.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "dir": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List releases — github.repos.list-releases

Run List releases with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a release — github.repos.create-release

Run Create a release with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.tag_name string Required The name of the tag.
body.target_commitish string Optional Specifies the commitish value that determines where the Git tag is created from. Can be any branch or commit SHA. Unused if the Git tag already exists. Default: the repository's default branch.
body.name string Optional The name of the release.
body.body string Optional Text describing the contents of the tag.
body.draft boolean Optional true to create a draft (unpublished) release, false to create a published one. default: false
body.prerelease boolean Optional true to identify the release as a prerelease. false to identify the release as a full release. default: false
body.discussion_category_name string Optional If specified, a discussion of the specified category is created and linked to the release. The value must be a category that already exists in the repository. For more information, see "Managing categories for discussions in your repository."
body.generate_release_notes boolean Optional Whether to automatically generate the name and body for this release. If name is specified, the specified name will be used; otherwise, a name will be automatically generated. If body is specified, the body will be pre-pended to the automatically generated notes. default: false
body.make_latest string Optional Specifies whether this release should be set as the latest release for the repository. Drafts and prereleases cannot be set as latest. Defaults to true for newly published releases. legacy specifies that the latest release should be determined based on the release creation date and higher semantic version. enum: ["true","false","legacy"]; default: "true"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "tag_name": "v1.0.0",
    "target_commitish": "master",
    "name": "v1.0.0",
    "body": "Description of the release",
    "draft": false,
    "prerelease": false,
    "generate_release_notes": false
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a release asset — github.repos.get-release-asset

Run Get a release asset with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.asset_id integer Required The unique identifier of the asset.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "asset_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a release asset — github.repos.update-release-asset

Run Update a release asset with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.asset_id integer Required The unique identifier of the asset.
body object Optional
body.name string Optional The file name of the asset.
body.label string Optional An alternate short description of the asset. Used in place of the filename.
body.state string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "asset_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a release asset — github.repos.delete-release-asset

Run Delete a release asset with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.asset_id integer Required The unique identifier of the asset.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "asset_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Generate release notes content for a release — github.repos.generate-release-notes

Run Generate release notes content for a release with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.tag_name string Required The tag name for the release. This can be an existing tag or a new one.
body.target_commitish string Optional Specifies the commitish value that will be the target for the release's tag. Required if the supplied tag_name does not reference an existing tag. Ignored if the tag_name already exists.
body.previous_tag_name string Optional The name of the previous tag to use as the starting point for the release notes. Use to manually specify the range for the set of changes considered as part this release.
body.configuration_file_path string Optional Specifies a path to a file in the repository containing configuration settings used for generating the release notes. If unspecified, the configuration file located in the repository at '.github/release.yml' or '.github/release.yaml' will be used. If that is not present, the default configuration will be used.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "tag_name": "v1.0.0",
    "target_commitish": "main",
    "previous_tag_name": "v0.9.2",
    "configuration_file_path": ".github/custom_release_config.yml"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the latest release — github.repos.get-latest-release

Run Get the latest release with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a release by tag name — github.repos.get-release-by-tag

Run Get a release by tag name with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.tag string Required tag parameter

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "tag": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a release — github.repos.get-release

Run Get a release with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.release_id integer Required The unique identifier of the release.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "release_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a release — github.repos.update-release

Run Update a release with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.release_id integer Required The unique identifier of the release.
body object Optional
body.tag_name string Optional The name of the tag.
body.target_commitish string Optional Specifies the commitish value that determines where the Git tag is created from. Can be any branch or commit SHA. Unused if the Git tag already exists. Default: the repository's default branch.
body.name string Optional The name of the release.
body.body string Optional Text describing the contents of the tag.
body.draft boolean Optional true makes the release a draft, and false publishes the release.
body.prerelease boolean Optional true to identify the release as a prerelease, false to identify the release as a full release.
body.make_latest string Optional Specifies whether this release should be set as the latest release for the repository. Drafts and prereleases cannot be set as latest. Defaults to true for newly published releases. legacy specifies that the latest release should be determined based on the release creation date and higher semantic version. enum: ["true","false","legacy"]; default: "true"
body.discussion_category_name string Optional If specified, a discussion of the specified category is created and linked to the release. The value must be a category that already exists in the repository. If there is already a discussion linked to the release, this parameter is ignored. For more information, see "Managing categories for discussions in your repository."

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "release_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a release — github.repos.delete-release

Run Delete a release with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.release_id integer Required The unique identifier of the release.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "release_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List release assets — github.repos.list-release-assets

Run List release assets with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.release_id integer Required The unique identifier of the release.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "release_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List reactions for a release — github.reactions.list-for-release

Run List reactions for a release with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.release_id integer Required The unique identifier of the release.
query object Optional additionalProperties: false
query.content string Optional Returns a single reaction type. Omit this parameter to list all reactions to a release. enum: ["+1","laugh","heart","hooray","rocket","eyes"]
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "release_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create reaction for a release — github.reactions.create-for-release

Run Create reaction for a release with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.release_id integer Required The unique identifier of the release.
body object Required
body.content string Required The reaction type to add to the release. enum: ["+1","laugh","heart","hooray","rocket","eyes"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "release_id": 1
  },
  "body": {
    "content": "heart"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a release reaction — github.reactions.delete-for-release

Run Delete a release reaction with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.release_id integer Required The unique identifier of the release.
path.reaction_id integer Required The unique identifier of the reaction.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "release_id": 1,
    "reaction_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get rules for a branch — github.repos.get-branch-rules

Run Get rules for a branch with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.branch string Required The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use the GraphQL API.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "branch": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get all repository rulesets — github.repos.get-repo-rulesets

Run Get all repository rulesets with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.includes_parents boolean Optional Include rulesets configured at higher levels that apply to this repository default: true
query.targets string Optional A comma-separated list of rule targets to filter by. If provided, only rulesets that apply to the specified targets will be returned. For example, branch,tag,push.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a repository ruleset — github.repos.create-repo-ruleset

Run Create a repository ruleset with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.name string Required The name of the ruleset.
body.target string Optional The target of the ruleset enum: ["branch","tag","push"]; default: "branch"
body.enforcement — Required $ref: "#/definitions/repository-rule-enforcement"
body.bypass_actors array Optional The actors that can bypass the rules in this ruleset
body.bypass_actors[] — Optional $ref: "#/definitions/repository-ruleset-bypass-actor"
body.conditions — Optional $ref: "#/definitions/repository-ruleset-conditions"
body.rules array Optional An array of rules within the ruleset.
body.rules[] — Optional $ref: "#/definitions/repository-rule"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "name": "super cool ruleset",
    "target": "branch",
    "enforcement": "active",
    "bypass_actors": [
      {
        "actor_id": 234,
        "actor_type": "Team",
        "bypass_mode": "always"
      }
    ],
    "conditions": {
      "ref_name": {
        "include": [
          "refs/heads/main",
          "refs/heads/master"
        ],
        "exclude": [
          "refs/heads/dev*"
        ]
      }
    },
    "rules": [
      {
        "type": "commit_author_email_pattern",
        "parameters": {
          "operator": "contains",
          "pattern": "github"
        }
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository rule suites — github.repos.get-repo-rule-suites

Run List repository rule suites with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.ref string Optional The name of the ref. Cannot contain wildcard characters. Optionally prefix with refs/heads/ to limit to branches or refs/tags/ to limit to tags. Omit the prefix to search across all refs. When specified, only rule evaluations triggered for this ref will be returned.
query.time_period string Optional The time period to filter by. For example, day will filter for rule suites that occurred in the past 24 hours, and week will filter for rule suites that occurred in the past 7 days (168 hours). enum: ["hour","day","week","month"]; default: "day"
query.actor_name string Optional The handle for the GitHub user account to filter on. When specified, only rule evaluations triggered by this actor will be returned.
query.rule_suite_result string Optional The rule suite results to filter on. When specified, only suites with this result will be returned. enum: ["pass","fail","bypass","all"]; default: "all"
query.evaluate_status string Optional The evaluate status to filter on. When specified, only rule suites resulting from rulesets with the specified evaluate status will be returned. - all - all rule suites will be returned. - active - only rule suites resulting from rulesets in active (non-evaluate) mode will be returned. - evaluate - only rule suites resulting from rulesets in evaluate mode will be returned. enum: ["all","active","evaluate"]; default: "all"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository rule suite — github.repos.get-repo-rule-suite

Run Get a repository rule suite with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.rule_suite_id integer Required The unique identifier of the rule suite result. To get this ID, you can use GET /repos/{owner}/{repo}/rulesets/rule-suites for repositories and GET /orgs/{org}/rulesets/rule-suites for organizations.
query object Optional additionalProperties: false
query.include_metadata boolean Optional When set to true, the response will include additional metadata for pull request and required status check rule evaluation. Results are capped at 50 entries. default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "rule_suite_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository ruleset — github.repos.get-repo-ruleset

Run Get a repository ruleset with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ruleset_id integer Required The ID of the ruleset.
query object Optional additionalProperties: false
query.includes_parents boolean Optional Include rulesets configured at higher levels that apply to this repository default: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ruleset_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a repository ruleset — github.repos.update-repo-ruleset

Run Update a repository ruleset with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ruleset_id integer Required The ID of the ruleset.
body object Optional
body.name string Optional The name of the ruleset.
body.target string Optional The target of the ruleset enum: ["branch","tag","push"]
body.enforcement — Optional $ref: "#/definitions/repository-rule-enforcement"
body.bypass_actors array Optional The actors that can bypass the rules in this ruleset
body.bypass_actors[] — Optional $ref: "#/definitions/repository-ruleset-bypass-actor"
body.conditions — Optional $ref: "#/definitions/repository-ruleset-conditions"
body.rules array Optional An array of rules within the ruleset.
body.rules[] — Optional $ref: "#/definitions/repository-rule"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ruleset_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a repository ruleset — github.repos.delete-repo-ruleset

Run Delete a repository ruleset with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ruleset_id integer Required The ID of the ruleset.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ruleset_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get repository ruleset history — github.repos.get-repo-ruleset-history

Run Get repository ruleset history with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ruleset_id integer Required The ID of the ruleset.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ruleset_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get repository ruleset version — github.repos.get-repo-ruleset-version

Run Get repository ruleset version with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ruleset_id integer Required The ID of the ruleset.
path.version_id integer Required The ID of the version

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ruleset_id": 1,
    "version_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List secret scanning alerts for a repository — github.secret-scanning.list-alerts-for-repo

Run List secret scanning alerts for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.state string Optional Set to open or resolved to only list secret scanning alerts in a specific state. enum: ["open","resolved"]
query.secret_type string Optional A comma-separated list of secret types to return. All default secret patterns are returned. To return generic patterns, pass the token name(s) in the parameter. See "Supported secret scanning patterns" for a complete list of secret types.
query.exclude_secret_types string Optional A comma-separated list of secret types to exclude from the results. All default secret patterns are returned except those matching the specified types. Cannot be combined with the secret_type parameter. See "Supported secret scanning patterns" for a complete list of secret types.
query.exclude_providers string Optional A comma-separated list of provider slugs to exclude from the results. Provider slugs use lowercase with underscores (e.g., github_secret_scanning, clojars). You can find the provider slug in the provider_slug field of each alert. Cannot be combined with the providers parameter.
query.providers string Optional A comma-separated list of provider slugs to filter by. Provider slugs use lowercase with underscores (e.g., github_secret_scanning, clojars). You can find the provider slug in the provider_slug field of each alert. Cannot be combined with the exclude_providers parameter.
query.resolution string Optional A comma-separated list of resolutions. Only secret scanning alerts with one of these resolutions are listed. Valid resolutions are false_positive, wont_fix, revoked, pattern_edited, pattern_deleted or used_in_tests.
query.assignee string Optional Filters alerts by assignee. Use * to get all assigned alerts, none to get all unassigned alerts, or a GitHub username to get alerts assigned to a specific user.
query.sort string Optional The property to sort the results by. created means when the alert was created. updated means when the alert was updated or resolved. enum: ["created","updated"]; default: "created"
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for events before this cursor. To receive an initial cursor on your first request, include an empty "before" query string.
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for events after this cursor. To receive an initial cursor on your first request, include an empty "after" query string.
query.validity string Optional A comma-separated list of validities that, when present, will return alerts that match the validities in this list. Valid options are active, inactive, and unknown.
query.is_publicly_leaked boolean Optional A boolean value representing whether or not to filter alerts by the publicly-leaked tag being present. default: false
query.is_multi_repo boolean Optional A boolean value representing whether or not to filter alerts by the multi-repo tag being present. default: false
query.hide_secret boolean Optional A boolean value representing whether or not to hide literal secrets in the results. default: false
query.is_bypassed boolean Optional A boolean value (true or false) indicating whether to filter alerts by their push protection bypass status. When set to true, only alerts that were created because a push protection rule was bypassed will be returned. When set to false, only alerts that were not caused by a push protection bypass will be returned.
query.included_metadata string Optional A comma-separated list of metadata fields to filter alerts by. Only alerts that have all of the specified metadata fields attached will be returned. Possible values are: owner-email, owner-id, owner-name, secret-id, secret-name, secret-issued-date, secret-expiration-date, organization-name, organization-id, last-used-date, and has-organization-access.
query.owner_email_hash string Optional Filters alerts to only those whose attached owner_email metadata field matches the provided value. The value must be the lowercase hex-encoded SHA-256 hash of the email address to match (for example, the SHA-256 of [email protected]). Only alerts that have an owner_email metadata value whose SHA-256 hash equals this parameter are returned.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a secret scanning alert — github.secret-scanning.get-alert

Run Get a secret scanning alert with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.alert_number — Required The number that identifies an alert. You can find this at the end of the URL for a code scanning alert within GitHub, and in the number field in the response from the GET /repos/{owner}/{repo}/code-scanning/alerts operation. $ref: "#/definitions/alert-number"
query object Optional additionalProperties: false
query.hide_secret boolean Optional A boolean value representing whether or not to hide literal secrets in the results. default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "alert_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a secret scanning alert — github.secret-scanning.update-alert

Run Update a secret scanning alert with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.alert_number — Required The number that identifies an alert. You can find this at the end of the URL for a code scanning alert within GitHub, and in the number field in the response from the GET /repos/{owner}/{repo}/code-scanning/alerts operation. $ref: "#/definitions/alert-number"
body object Required
body.state — Optional $ref: "#/definitions/secret-scanning-alert-state"
body.resolution — Optional $ref: "#/definitions/secret-scanning-alert-resolution"
body.resolution_comment — Optional $ref: "#/definitions/secret-scanning-alert-resolution-comment"
body.assignee — Optional $ref: "#/definitions/secret-scanning-alert-assignee"
body.validity string | null Optional Sets the validity of the secret scanning alert. Can be active, inactive, or null to clear the override. enum: ["active","inactive"]
body — Required anyOf[1]
body — Required anyOf[2]
body — Required anyOf[3]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "alert_number": 1
  },
  "body": {
    "state": "resolved",
    "resolution": "false_positive"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List locations for a secret scanning alert — github.secret-scanning.list-locations-for-alert

Run List locations for a secret scanning alert with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.alert_number — Required The number that identifies an alert. You can find this at the end of the URL for a code scanning alert within GitHub, and in the number field in the response from the GET /repos/{owner}/{repo}/code-scanning/alerts operation. $ref: "#/definitions/alert-number"
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "alert_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository custom patterns — github.secret-scanning.list-repo-custom-patterns

Run List repository custom patterns with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.state string Optional Filter custom patterns by state. When absent, returns patterns in all states. enum: ["published","unpublished"]
query.push_protection string Optional Filter custom patterns by whether push protection is enabled. When absent, returns patterns regardless of push protection status. enum: ["enabled","disabled"]
query.sort string Optional The property to sort the results by. enum: ["created","updated","name"]; default: "created"
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Bulk create repository custom patterns — github.secret-scanning.bulk-create-repo-custom-patterns

Run Bulk create repository custom patterns with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.patterns array Required The list of custom patterns to create (maximum 100). maxItems: 100
body.patterns[] — Optional $ref: "#/definitions/secret-scanning-custom-pattern-to-create"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "patterns": []
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Bulk delete repository custom patterns — github.secret-scanning.bulk-delete-repo-custom-patterns

Run Bulk delete repository custom patterns with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.patterns array Required The list of custom patterns to delete. maxItems: 500
body.patterns[] — Optional $ref: "#/definitions/secret-scanning-custom-pattern-to-delete"
body.post_delete_action string Optional What to do with alerts associated with the deleted patterns. delete_alerts permanently removes the alerts. resolve_alerts resolves the alerts as "pattern deleted". Defaults to delete_alerts when not specified. enum: ["delete_alerts","resolve_alerts"]; default: "delete_alerts"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "patterns": []
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a repository custom pattern — github.secret-scanning.update-repo-custom-pattern

Run Update a repository custom pattern with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.pattern_id integer Required The ID of the custom pattern.
body — Required $ref: "#/definitions/secret-scanning-custom-pattern-to-update"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "pattern_id": 1
  },
  "body": {
    "custom_pattern_version": "example",
    "pattern": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a push protection bypass — github.secret-scanning.create-push-protection-bypass

Run Create a push protection bypass with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.reason — Required $ref: "#/definitions/secret-scanning-push-protection-bypass-reason"
body.placeholder_id — Required $ref: "#/definitions/secret-scanning-push-protection-bypass-placeholder-id"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "reason": "will_fix_later",
    "placeholder_id": "2k4dM4tseyC5lPIsjl5emX9sPNk"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get secret scanning scan history for a repository — github.secret-scanning.get-scan-history

Run Get secret scanning scan history for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository security advisories — github.security-advisories.list-repository-advisories

Run List repository security advisories with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.sort string Optional The property to sort the results by. enum: ["created","updated","published"]; default: "created"
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.per_page integer Optional The number of advisories to return per page. For more information, see "Using pagination in the REST API." default: 30; minimum: 1; maximum: 100
query.state string Optional Filter by state of the repository advisories. Only advisories of this state will be returned. enum: ["triage","draft","published","closed"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a repository security advisory — github.security-advisories.create-repository-advisory

Run Create a repository security advisory with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body — Required $ref: "#/definitions/repository-advisory-create"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "summary": "example",
    "description": "example",
    "vulnerabilities": []
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Privately report a security vulnerability — github.security-advisories.create-private-vulnerability-report

Run Privately report a security vulnerability with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body — Required $ref: "#/definitions/private-vulnerability-report-create"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "summary": "example",
    "description": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository security advisory — github.security-advisories.get-repository-advisory

Run Get a repository security advisory with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ghsa_id string Required The GHSA (GitHub Security Advisory) identifier of the advisory.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ghsa_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a repository security advisory — github.security-advisories.update-repository-advisory

Run Update a repository security advisory with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ghsa_id string Required The GHSA (GitHub Security Advisory) identifier of the advisory.
body — Required $ref: "#/definitions/repository-advisory-update"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ghsa_id": "example"
  },
  "body": {}
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository security advisory comments — github.security-advisories.list-repository-advisory-comments

Run List repository security advisory comments with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ghsa_id string Required The GHSA (GitHub Security Advisory) identifier of the advisory.
query object Optional additionalProperties: false
query.since string Optional Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ghsa_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a repository advisory comment — github.security-advisories.create-repository-advisory-comment

Run Create a repository advisory comment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ghsa_id string Required The GHSA (GitHub Security Advisory) identifier of the advisory.
body object Required
body.body string Required The contents of the comment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ghsa_id": "example"
  },
  "body": {
    "body": "Thanks for the report. We are working on a fix."
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository advisory comment — github.security-advisories.get-repository-advisory-comment

Run Get a repository advisory comment with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ghsa_id string Required The GHSA (GitHub Security Advisory) identifier of the advisory.
path.comment_id integer Required The unique identifier of the comment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ghsa_id": "example",
    "comment_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a repository advisory comment — github.security-advisories.update-repository-advisory-comment

Run Update a repository advisory comment with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ghsa_id string Required The GHSA (GitHub Security Advisory) identifier of the advisory.
path.comment_id integer Required The unique identifier of the comment.
body object Required
body.body string Required The contents of the comment.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ghsa_id": "example",
    "comment_id": 1
  },
  "body": {
    "body": "Updated comment body."
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Request a CVE for a repository security advisory — github.security-advisories.create-repository-advisory-cve-request

Run Request a CVE for a repository security advisory with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ghsa_id string Required The GHSA (GitHub Security Advisory) identifier of the advisory.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ghsa_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a temporary private fork — github.security-advisories.create-fork

Run Create a temporary private fork with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.ghsa_id string Required The GHSA (GitHub Security Advisory) identifier of the advisory.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "ghsa_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List pull request stacks — github.pull-request-stacks.list

Run List pull request stacks with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.pull_request integer Optional Filter to the stack containing this repository pull request number.
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a pull request stack — github.pull-request-stacks.create

Run Create a pull request stack with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.pull_requests array Required An ordered list of pull request numbers forming the stack from bottom to top. minItems: 2; maxItems: 100
body.pull_requests[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "pull_requests": [
      101,
      102,
      103
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a pull request stack — github.pull-request-stacks.get

Run Get a pull request stack with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.stack_number integer Required The number that identifies the pull request stack.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "stack_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add pull requests to a pull request stack — github.pull-request-stacks.add

Run Add pull requests to a pull request stack with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.stack_number integer Required The number that identifies the pull request stack.
body object Required
body.pull_requests array Required An ordered list of pull request numbers to append to the stack, from the current top upward. minItems: 1; maxItems: 100
body.pull_requests[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "stack_number": 1
  },
  "body": {
    "pull_requests": [
      104,
      102
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove pull requests from a pull request stack — github.pull-request-stacks.unstack

Run Remove pull requests from a pull request stack with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.stack_number integer Required The number that identifies the pull request stack.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "stack_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List stargazers — github.activity.list-stargazers-for-repo

Run List stargazers with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get stargazer count — github.activity.get-stargazer-count-for-repo

Run Get stargazer count with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get repository star history — github.activity.get-stargazer-history-for-repo

Run Get repository star history with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 30). For more information, see "Using pagination in the REST API." default: 30; minimum: 1; maximum: 30
query.page integer Optional The page number of the results to fetch (max 100). For more information, see "Using pagination in the REST API." default: 1; minimum: 1; maximum: 100

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the weekly commit activity — github.repos.get-code-frequency-stats

Run Get the weekly commit activity with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the last year of commit activity — github.repos.get-commit-activity-stats

Run Get the last year of commit activity with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get all contributor commit activity — github.repos.get-contributors-stats

Run Get all contributor commit activity with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the weekly commit count — github.repos.get-participation-stats

Run Get the weekly commit count with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the hourly commit count for each day — github.repos.get-punch-card-stats

Run Get the hourly commit count for each day with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a commit status — github.repos.create-commit-status

Run Create a commit status with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
path.sha string Required
body object Required
body.state string Required The state of the status. enum: ["error","failure","pending","success"]
body.target_url string | null Optional The target URL to associate with this status. This URL will be linked from the GitHub UI to allow users to easily see the source of the status. For example, if your continuous integration system is posting build status, you would want to provide the deep link for the build output for this specific SHA: http://ci.example.com/user/repo/build/sha
body.description string | null Optional A short description of the status.
body.context string Optional A string label to differentiate this status from the status of other systems. This field is case-insensitive. default: "default"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world",
    "sha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  },
  "body": {
    "state": "success",
    "target_url": "https://example.com/build/status",
    "description": "The build succeeded!",
    "context": "continuous-integration/jenkins"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List watchers — github.activity.list-watchers-for-repo

Run List watchers with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a repository subscription — github.activity.get-repo-subscription

Run Get a repository subscription with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set a repository subscription — github.activity.set-repo-subscription

Run Set a repository subscription with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Optional
body.subscribed boolean Optional Determines if notifications should be received from this repository.
body.ignored boolean Optional Determines if all notifications should be blocked from this repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a repository subscription — github.activity.delete-repo-subscription

Run Delete a repository subscription with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository tags — github.repos.list-tags

Run List repository tags with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository teams — github.repos.list-teams

Run List repository teams with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get all repository topics — github.repos.get-all-topics

Run Get all repository topics with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Replace all repository topics — github.repos.replace-all-topics

Run Replace all repository topics with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.names array Required An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names will be saved as lowercase.
body.names[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "names": [
      "octocat",
      "atom",
      "electron",
      "api"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get repository clones — github.repos.get-clones

Run Get repository clones with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per string Optional The time frame to display results for. enum: ["day","week"]; default: "day"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get top referral paths — github.repos.get-top-paths

Run Get top referral paths with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get top referral sources — github.repos.get-top-referrers

Run Get top referral sources with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get page views — github.repos.get-views

Run Get page views with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
query object Optional additionalProperties: false
query.per string Optional The time frame to display results for. enum: ["day","week"]; default: "day"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Transfer a repository — github.repos.transfer

Run Transfer a repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.
body object Required
body.new_owner string Required The username or organization name the repository will be transferred to.
body.new_name string Optional The new name to be given to the repository.
body.team_ids array Optional ID of the team or teams to add to the repository. Teams can only be added to organization-owned repositories.
body.team_ids[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  },
  "body": {
    "new_owner": "github",
    "team_ids": [
      12,
      345
    ],
    "new_name": "octorepo"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check if vulnerability alerts are enabled for a repository — github.repos.check-vulnerability-alerts

Run Check if vulnerability alerts are enabled for a repository with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Enable vulnerability alerts — github.repos.enable-vulnerability-alerts

Run Enable vulnerability alerts with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Disable vulnerability alerts — github.repos.disable-vulnerability-alerts

Run Disable vulnerability alerts with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a repository using a template — github.repos.create-using-template

Run Create a repository using a template with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.template_owner string Required The account owner of the template repository. The name is not case sensitive.
path.template_repo string Required The name of the template repository without the .git extension. The name is not case sensitive.
body object Required
body.owner string Optional The organization or person who will own the new repository. To create a new repository in an organization, the authenticated user must be a member of the specified organization.
body.name string Required The name of the new repository.
body.description string Optional A short description of the new repository.
body.include_all_branches boolean Optional Set to true to include the directory structure and files from all branches in the template repository, and not just the default branch. Default: false. default: false
body.private boolean Optional Either true to create a new private repository or false to create a new public one. default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "template_owner": "example",
    "template_repo": "example"
  },
  "body": {
    "owner": "octocat",
    "name": "Hello-World",
    "description": "This is your first repository",
    "include_all_branches": false,
    "private": false
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List public repositories — github.repos.list-public

Run List public repositories with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.since integer Optional A repository ID. Only return repositories with an ID greater than this ID.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Search code — github.search.code

Run Search code with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Required additionalProperties: false
query.q string Required The query contains one or more search keywords and qualifiers. Qualifiers allow you to limit your search to specific areas of GitHub. The REST API supports the same qualifiers as the web interface for GitHub. To learn more about the format of the query, see Constructing a search query. See "Searching code" for a detailed list of qualifiers.
query.sort string Optional This field is closing down. Sorts the results of your query. Can only be indexed, which indicates how recently a file has been indexed by the GitHub search infrastructure. Default: best match enum: ["indexed"]
query.order string Optional This field is closing down. Determines 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 sort. enum: ["desc","asc"]; default: "desc"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "q": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Search commits — github.search.commits

Run Search commits with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Required additionalProperties: false
query.q string Required The query contains one or more search keywords and qualifiers. Qualifiers allow you to limit your search to specific areas of GitHub. The REST API supports the same qualifiers as the web interface for GitHub. To learn more about the format of the query, see Constructing a search query. See "Searching commits" for a detailed list of qualifiers.
query.sort string Optional Sorts the results of your query by author-date or committer-date. Default: best match enum: ["author-date","committer-date"]
query.order string Optional Determines 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 sort. enum: ["desc","asc"]; default: "desc"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "q": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Search issues and pull requests — github.search.issues-and-pull-requests

Run Search issues and pull requests with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Required additionalProperties: false
query.q string Required The query contains one or more search keywords and qualifiers. Qualifiers allow you to limit your search to specific areas of GitHub. The REST API supports the same qualifiers as the web interface for GitHub. To learn more about the format of the query, see Constructing a search query. See "Searching issues and pull requests" for a detailed list of qualifiers.
query.sort string Optional Sorts the results of your query by the number of comments, reactions, reactions-+1, reactions--1, reactions-smile, reactions-thinking_face, reactions-heart, reactions-tada, or interactions. You can also sort results by how recently the items were created or updated, Default: best match enum: ["comments","reactions","reactions-+1","reactions--1","reactions-smile","reactions-thinking_face","reactions-heart","reactions-tada","interactions","created","updated"]
query.order string Optional Determines 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 sort. enum: ["desc","asc"]; default: "desc"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.advanced_search string Optional Set to true to use advanced search. Example: http://api.github.com/search/issues?q={query}&advanced_search=true
query.search_type string Optional The type of search to perform on issues. When not specified, the default is lexical search. - semantic — performs a pure semantic (vector) search using embedding-based understanding. - hybrid — combines semantic search with lexical search for best results. Semantic and hybrid search require authentication and are rate limited to 10 requests per minute. Only applies to issue searches (/search/issues). enum: ["semantic","hybrid"]

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "q": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Search labels — github.search.labels

Run Search labels with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Required additionalProperties: false
query.repository_id integer Required The id of the repository.
query.q string Required The search keywords. This endpoint does not accept qualifiers in the query. To learn more about the format of the query, see Constructing a search query.
query.sort string Optional Sorts the results of your query by when the label was created or updated. Default: best match enum: ["created","updated"]
query.order string Optional Determines 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 sort. enum: ["desc","asc"]; default: "desc"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "repository_id": 1,
    "q": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Search repositories — github.search.repos

Run Search repositories with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Required additionalProperties: false
query.q string Required The query contains one or more search keywords and qualifiers. Qualifiers allow you to limit your search to specific areas of GitHub. The REST API supports the same qualifiers as the web interface for GitHub. To learn more about the format of the query, see Constructing a search query. See "Searching for repositories" for a detailed list of qualifiers.
query.sort string Optional Sorts the results of your query by number of stars, forks, or help-wanted-issues or how recently the items were updated. Default: best match enum: ["stars","forks","help-wanted-issues","updated"]
query.order string Optional Determines 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 sort. enum: ["desc","asc"]; default: "desc"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "q": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Search topics — github.search.topics

Run Search topics with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Required additionalProperties: false
query.q string Required The query contains one or more search keywords and qualifiers. Qualifiers allow you to limit your search to specific areas of GitHub. The REST API supports the same qualifiers as the web interface for GitHub. To learn more about the format of the query, see Constructing a search query.
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "q": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Search users — github.search.users

Run Search users with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Required additionalProperties: false
query.q string Required The query contains one or more search keywords and qualifiers. Qualifiers allow you to limit your search to specific areas of GitHub. The REST API supports the same qualifiers as the web interface for GitHub. To learn more about the format of the query, see Constructing a search query. See "Searching users" for a detailed list of qualifiers.
query.sort string Optional Sorts the results of your query by number of followers or repositories, or when the person joined GitHub. Default: best match enum: ["followers","repositories","joined"]
query.order string Optional Determines 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 sort. enum: ["desc","asc"]; default: "desc"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "q": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the authenticated user — github.users.get-authenticated

Run Get the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update the authenticated user — github.users.update-authenticated

Run Update the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
body object Optional
body.name string Optional The new name of the user.
body.email string Optional The publicly visible email address of the user.
body.blog string Optional The new blog URL of the user.
body.twitter_username string | null Optional The new Twitter username of the user.
body.company string Optional The new company of the user.
body.location string Optional The new location of the user.
body.hireable boolean Optional The new hiring availability of the user.
body.bio string Optional The new short biography of the user.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List users blocked by the authenticated user — github.users.list-blocked-by-authenticated-user

Run List users blocked by the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check if a user is blocked by the authenticated user — github.users.check-blocked

Run Check if a user is blocked by the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Block a user — github.users.block

Run Block a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Unblock a user — github.users.unblock

Run Unblock a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List codespaces for the authenticated user — github.codespaces.list-for-authenticated-user

Run List codespaces for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.repository_id integer Optional ID of the Repository to filter on

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a codespace for the authenticated user — github.codespaces.create-for-authenticated-user

Run Create a codespace for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
body — Required
body object Required oneOf[1]
body.repository_id integer Required Repository id for this codespace oneOf[1]
body.ref string Optional Git ref (typically a branch name) for this codespace oneOf[1]
body.location string Optional The requested location for a new codespace. Best efforts are made to respect this upon creation. Assigned by IP if not provided. oneOf[1]
body.geo string Optional The geographic area for this codespace. If not specified, the value is assigned by IP. This property replaces location, which is closing down. oneOf[1]; enum: ["EuropeWest","SoutheastAsia","UsEast","UsWest"]
body.client_ip string Optional IP for location auto-detection when proxying a request oneOf[1]
body.machine string Optional Machine type to use for this codespace oneOf[1]
body.devcontainer_path string Optional Path to devcontainer.json config to use for this codespace oneOf[1]
body.multi_repo_permissions_opt_out boolean Optional Whether to authorize requested permissions from devcontainer.json oneOf[1]
body.working_directory string Optional Working directory for this codespace oneOf[1]
body.idle_timeout_minutes integer Optional Time in minutes before codespace stops from inactivity oneOf[1]
body.display_name string Optional Display name for this codespace oneOf[1]
body.retention_period_minutes integer Optional Duration in minutes after codespace has gone idle in which it will be deleted. Must be integer minutes between 0 and 43200 (30 days). oneOf[1]
body object Required oneOf[2]
body.pull_request object Required Pull request number for this codespace oneOf[2]
body.pull_request.pull_request_number integer Required Pull request number oneOf[2]
body.pull_request.repository_id integer Required Repository id for this codespace oneOf[2]
body.location string Optional The requested location for a new codespace. Best efforts are made to respect this upon creation. Assigned by IP if not provided. oneOf[2]
body.geo string Optional The geographic area for this codespace. If not specified, the value is assigned by IP. This property replaces location, which is closing down. oneOf[2]; enum: ["EuropeWest","SoutheastAsia","UsEast","UsWest"]
body.machine string Optional Machine type to use for this codespace oneOf[2]
body.devcontainer_path string Optional Path to devcontainer.json config to use for this codespace oneOf[2]
body.working_directory string Optional Working directory for this codespace oneOf[2]
body.idle_timeout_minutes integer Optional Time in minutes before codespace stops from inactivity oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "body": {
    "repository_id": 1,
    "ref": "main",
    "geo": "UsWest"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List secrets for the authenticated user — github.codespaces.list-secrets-for-authenticated-user

Run List secrets for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get public key for the authenticated user — github.codespaces.get-public-key-for-authenticated-user

Run Get public key for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a secret for the authenticated user — github.codespaces.get-secret-for-authenticated-user

Run Get a secret for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create or update a secret for the authenticated user — github.codespaces.create-or-update-secret-for-authenticated-user

Run Create or update a secret for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.secret_name string Required The name of the secret.
body object Required
body.encrypted_value string Optional Value for your secret, encrypted with LibSodium using the public key retrieved from the Get the public key for the authenticated user endpoint. pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$"
body.key_id string Required ID of the key you used to encrypt the secret.
body.selected_repository_ids array Optional An array of repository ids that can access the user secret. You can manage the list of selected repositories using the List selected repositories for a user secret, Set selected repositories for a user secret, and Remove a selected repository from a user secret endpoints.
body.selected_repository_ids[] — Optional
body.selected_repository_ids[] integer Optional anyOf[1]
body.selected_repository_ids[] string Optional anyOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "secret_name": "example"
  },
  "body": {
    "encrypted_value": "c2VjcmV0",
    "key_id": "012345678912345678",
    "selected_repository_ids": [
      "1234567",
      "2345678"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a secret for the authenticated user — github.codespaces.delete-secret-for-authenticated-user

Run Delete a secret for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List selected repositories for a user secret — github.codespaces.list-repositories-for-secret-for-authenticated-user

Run List selected repositories for a user secret with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.secret_name string Required The name of the secret.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "secret_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add a selected repository to a user secret — github.codespaces.add-repository-for-secret-for-authenticated-user

Run Add a selected repository to a user secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.secret_name string Required The name of the secret.
path.repository_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "secret_name": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove a selected repository from a user secret — github.codespaces.remove-repository-for-secret-for-authenticated-user

Run Remove a selected repository from a user secret with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.secret_name string Required The name of the secret.
path.repository_id integer Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "secret_name": "example",
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a codespace for the authenticated user — github.codespaces.get-for-authenticated-user

Run Get a codespace for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.codespace_name string Required The name of the codespace.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "codespace_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update a codespace for the authenticated user — github.codespaces.update-for-authenticated-user

Run Update a codespace for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.codespace_name string Required The name of the codespace.
body object Optional
body.machine string Optional A valid machine to transition this codespace to.
body.display_name string Optional Display name for this codespace
body.recent_folders array Optional Recently opened folders inside the codespace. It is currently used by the clients to determine the folder path to load the codespace in.
body.recent_folders[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "codespace_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a codespace for the authenticated user — github.codespaces.delete-for-authenticated-user

Run Delete a codespace for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.codespace_name string Required The name of the codespace.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "codespace_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Export a codespace for the authenticated user — github.codespaces.export-for-authenticated-user

Run Export a codespace for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.codespace_name string Required The name of the codespace.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "codespace_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get details about a codespace export — github.codespaces.get-export-details-for-authenticated-user

Run Get details about a codespace export with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.codespace_name string Required The name of the codespace.
path.export_id string Required The ID of the export operation, or latest. Currently only latest is currently supported.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "codespace_name": "example",
    "export_id": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List machine types for a codespace — github.codespaces.codespace-machines-for-authenticated-user

Run List machine types for a codespace with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.codespace_name string Required The name of the codespace.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "codespace_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a repository from an unpublished codespace — github.codespaces.publish-for-authenticated-user

Run Create a repository from an unpublished codespace with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.codespace_name string Required The name of the codespace.
body object Required
body.name string Optional A name for the new repository.
body.private boolean Optional Whether the new repository should be private. default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "codespace_name": "example"
  },
  "body": {
    "repository": "monalisa-octocat-hello-world-g4wpq6h95q",
    "private": false
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Start a codespace for the authenticated user — github.codespaces.start-for-authenticated-user

Run Start a codespace for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.codespace_name string Required The name of the codespace.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "codespace_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Stop a codespace for the authenticated user — github.codespaces.stop-for-authenticated-user

Run Stop a codespace for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.codespace_name string Required The name of the codespace.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "codespace_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get list of conflicting packages during Docker migration for authenticated-user — github.packages.list-docker-migration-conflicting-packages-for-authen-63152eb7cf

Run Get list of conflicting packages during Docker migration for authenticated-user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set primary email visibility for the authenticated user — github.users.set-primary-email-visibility-for-authenticated-user

Run Set primary email visibility for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
body object Required
body.visibility string Required Denotes whether an email is publicly visible. enum: ["public","private"]

Full JSON Schema

Full JSON Schema

Example input

{
  "body": {
    "visibility": "private"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List email addresses for the authenticated user — github.users.list-emails-for-authenticated-user

Run List email addresses for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add an email address for the authenticated user — github.users.add-email-for-authenticated-user

Run Add an email address for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
body — Optional
body object Optional oneOf[1]
body.emails array Required Adds one or more email addresses to your GitHub account. Must contain at least one email address. Note: Alternatively, you can pass a single email address or an array of emails addresses directly, but we recommend that you pass an object using the emails key. oneOf[1]; minItems: 1
body.emails[] string Optional oneOf[1]
body array Optional oneOf[2]; minItems: 1
body[] string Optional oneOf[2]
body string Optional oneOf[3]

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an email address for the authenticated user — github.users.delete-email-for-authenticated-user

Run Delete an email address for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
body — Optional
body object Optional Deletes one or more email addresses from your GitHub account. Must contain at least one email address. Note: Alternatively, you can pass a single email address or an array of emails addresses directly, but we recommend that you pass an object using the emails key. oneOf[1]
body.emails array Required Email addresses associated with the GitHub user account. oneOf[1]; minItems: 1
body.emails[] string Optional oneOf[1]
body array Optional oneOf[2]; minItems: 1
body[] string Optional oneOf[2]
body string Optional oneOf[3]

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List followers of the authenticated user — github.users.list-followers-for-authenticated-user

Run List followers of the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List the people the authenticated user follows — github.users.list-followed-by-authenticated-user

Run List the people the authenticated user follows with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check if a person is followed by the authenticated user — github.users.check-person-is-followed-by-authenticated

Run Check if a person is followed by the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Follow a user — github.users.follow

Run Follow a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Unfollow a user — github.users.unfollow

Run Unfollow a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List GPG keys for the authenticated user — github.users.list-gpg-keys-for-authenticated-user

Run List GPG keys for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a GPG key for the authenticated user — github.users.create-gpg-key-for-authenticated-user

Run Create a GPG key for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
body object Required
body.name string Optional A descriptive name for the new key.
body.armored_public_key string Required A GPG key in ASCII-armored format.

Full JSON Schema

Full JSON Schema

Example input

{
  "body": {
    "name": "Octocat's GPG Key",
    "armored_public_key": "-----BEGIN PGP PUBLIC KEY BLOCK-----\nVersion: GnuPG v1\n\nmQINBFnZ2ZIBEADQ2Z7Z7\n-----END PGP PUBLIC KEY BLOCK-----"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a GPG key for the authenticated user — github.users.get-gpg-key-for-authenticated-user

Run Get a GPG key for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.gpg_key_id integer Required The unique identifier of the GPG key.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "gpg_key_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a GPG key for the authenticated user — github.users.delete-gpg-key-for-authenticated-user

Run Delete a GPG key for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.gpg_key_id integer Required The unique identifier of the GPG key.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "gpg_key_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List app installations accessible to the user access token — github.apps.list-installations-for-authenticated-user

Run List app installations accessible to the user access token with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repositories accessible to the user access token — github.apps.list-installation-repos-for-authenticated-user

Run List repositories accessible to the user access token with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.installation_id integer Required The unique identifier of the installation.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "installation_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add a repository to an app installation — github.apps.add-repo-to-installation-for-authenticated-user

Run Add a repository to an app installation with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.installation_id integer Required The unique identifier of the installation.
path.repository_id integer Required The unique identifier of the repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "installation_id": 1,
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove a repository from an app installation — github.apps.remove-repo-from-installation-for-authenticated-user

Run Remove a repository from an app installation with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.installation_id integer Required The unique identifier of the installation.
path.repository_id integer Required The unique identifier of the repository.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "installation_id": 1,
    "repository_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get interaction restrictions for your public repositories — github.interactions.get-restrictions-for-authenticated-user

Run Get interaction restrictions for your public repositories with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set interaction restrictions for your public repositories — github.interactions.set-restrictions-for-authenticated-user

Run Set interaction restrictions for your public repositories with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
body — Required $ref: "#/definitions/interaction-limit"

Full JSON Schema

Full JSON Schema

Example input

{
  "body": {
    "limit": "collaborators_only"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove interaction restrictions from your public repositories — github.interactions.remove-restrictions-for-authenticated-user

Run Remove interaction restrictions from your public repositories with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List user account issues assigned to the authenticated user — github.issues.list-for-authenticated-user

Run List user account issues assigned to the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.filter string Optional Indicates which sorts of issues to return. assigned means issues assigned to you. created means issues created by you. mentioned means issues mentioning you. subscribed means issues you're subscribed to updates for. all or repos means all issues you can see, regardless of participation or creation. enum: ["assigned","created","mentioned","subscribed","repos","all"]; default: "assigned"
query.state string Optional Indicates the state of the issues to return. enum: ["open","closed","all"]; default: "open"
query.labels string Optional A list of comma separated label names. Example: bug,ui,@high
query.sort string Optional What to sort results by. enum: ["created","updated","comments"]; default: "created"
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.since string Optional Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List public SSH keys for the authenticated user — github.users.list-public-ssh-keys-for-authenticated-user

Run List public SSH keys for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a public SSH key for the authenticated user — github.users.get-public-ssh-key-for-authenticated-user

Run Get a public SSH key for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.key_id integer Required The unique identifier of the key.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "key_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a public SSH key for the authenticated user — github.users.delete-public-ssh-key-for-authenticated-user

Run Delete a public SSH key for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.key_id integer Required The unique identifier of the key.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "key_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List subscriptions for the authenticated user — github.apps.list-subscriptions-for-authenticated-user

Run List subscriptions for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List subscriptions for the authenticated user (stubbed) — github.apps.list-subscriptions-for-authenticated-user-stubbed

Run List subscriptions for the authenticated user (stubbed) with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization memberships for the authenticated user — github.orgs.list-memberships-for-authenticated-user

Run List organization memberships for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.state string Optional Indicates the state of the memberships to return. If not specified, the API returns both active and pending memberships. enum: ["active","pending"]
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an organization membership for the authenticated user — github.orgs.get-membership-for-authenticated-user

Run Get an organization membership for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update an organization membership for the authenticated user — github.orgs.update-membership-for-authenticated-user

Run Update an organization membership for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.org string Required The organization name. The name is not case sensitive.
body object Required
body.state string Required The state that the membership should be in. Only "active" will be accepted. enum: ["active"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "org": "example"
  },
  "body": {
    "state": "active"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List user migrations — github.migrations.list-for-authenticated-user

Run List user migrations with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Start a user migration — github.migrations.start-for-authenticated-user

Run Start a user migration with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
body object Required
body.lock_repositories boolean Optional Lock the repositories being migrated at the start of the migration
body.exclude_metadata boolean Optional Indicates whether metadata should be excluded and only git source should be included for the migration.
body.exclude_git_data boolean Optional Indicates whether the repository git data should be excluded from the migration.
body.exclude_attachments boolean Optional Do not include attachments in the migration
body.exclude_releases boolean Optional Do not include releases in the migration
body.exclude_owner_projects boolean Optional Indicates whether projects owned by the organization or users should be excluded.
body.org_metadata_only boolean Optional Indicates whether this should only include organization metadata (repositories array should be empty and will ignore other flags). default: false
body.exclude array Optional Exclude attributes from the API response to improve performance
body.exclude[] string Optional Allowed values that can be passed to the exclude param. enum: ["repositories"]
body.repositories array Required
body.repositories[] string Optional Repository path, owner and name

Full JSON Schema

Full JSON Schema

Example input

{
  "body": {
    "repositories": [
      "octocat/Hello-World"
    ],
    "lock_repositories": true
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a user migration status — github.migrations.get-status-for-authenticated-user

Run Get a user migration status with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.migration_id integer Required The unique identifier of the migration.
query object Optional additionalProperties: false
query.exclude array Optional
query.exclude[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "migration_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a user migration archive — github.migrations.delete-archive-for-authenticated-user

Run Delete a user migration archive with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.migration_id integer Required The unique identifier of the migration.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "migration_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Unlock a user repository — github.migrations.unlock-repo-for-authenticated-user

Run Unlock a user repository with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.migration_id integer Required The unique identifier of the migration.
path.repo_name string Required repo_name parameter

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "migration_id": 1,
    "repo_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repositories for a user migration — github.migrations.list-repos-for-authenticated-user

Run List repositories for a user migration with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.migration_id integer Required The unique identifier of the migration.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "migration_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organizations for the authenticated user — github.orgs.list-for-authenticated-user

Run List organizations for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List packages for the authenticated user's namespace — github.packages.list-packages-for-authenticated-user

Run List packages for the authenticated user's namespace with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Required additionalProperties: false
query.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
query.visibility string Optional The selected visibility of the packages. This parameter is optional and only filters an existing result set. The internal visibility is only supported for GitHub Packages registries that allow for granular permissions. For other ecosystems internal is synonymous with private. For the list of GitHub Packages registries that support granular permissions, see "About permissions for GitHub Packages." enum: ["public","private","internal"]
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "package_type": "npm"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a package for the authenticated user — github.packages.get-package-for-authenticated-user

Run Get a package for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a package for the authenticated user — github.packages.delete-package-for-authenticated-user

Run Delete a package for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Restore a package for the authenticated user — github.packages.restore-package-for-authenticated-user

Run Restore a package for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
query object Optional additionalProperties: false
query.token string Optional package token

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List package versions for a package owned by the authenticated user — github.packages.get-all-package-versions-for-package-owned-by-authenticated-user

Run List package versions for a package owned by the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
query object Optional additionalProperties: false
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.state string Optional The state of the package, either active or deleted. enum: ["active","deleted"]; default: "active"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a package version for the authenticated user — github.packages.get-package-version-for-authenticated-user

Run Get a package version for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
path.package_version_id integer Required Unique identifier of the package version.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example",
    "package_version_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a package version for the authenticated user — github.packages.delete-package-version-for-authenticated-user

Run Delete a package version for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
path.package_version_id integer Required Unique identifier of the package version.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example",
    "package_version_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Restore a package version for the authenticated user — github.packages.restore-package-version-for-authenticated-user

Run Restore a package version for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
path.package_version_id integer Required Unique identifier of the package version.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example",
    "package_version_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List public email addresses for the authenticated user — github.users.list-public-emails-for-authenticated-user

Run List public email addresses for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repositories for the authenticated user — github.repos.list-for-authenticated-user

Run List repositories for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.visibility string Optional Limit results to repositories with the specified visibility. enum: ["all","public","private"]; default: "all"
query.affiliation string Optional Comma-separated list of values. Can include: * owner: Repositories that are owned by the authenticated user. * collaborator: Repositories that the user has been added to as a collaborator. * organization_member: Repositories that the user has access to through being a member of an organization. This includes every repository on every team that the user is on. default: "owner,collaborator,organization_member"
query.type string Optional Limit results to repositories of the specified type. Will cause a 422 error if used in the same request as visibility or affiliation. enum: ["all","owner","public","private","member"]; default: "all"
query.sort string Optional The property to sort the results by. enum: ["created","updated","pushed","full_name"]; default: "full_name"
query.direction string Optional The order to sort by. Default: asc when using full_name, otherwise desc. enum: ["asc","desc"]
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.since string Optional Only show repositories updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.before string Optional Only show repositories updated before the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a repository for the authenticated user — github.repos.create-for-authenticated-user

Run Create a repository for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
body object Required
body.name string Required The name of the repository.
body.description string Optional A short description of the repository.
body.homepage string Optional A URL with more information about the repository.
body.private boolean Optional Whether the repository is private. default: false
body.has_issues boolean Optional Whether issues are enabled. default: true
body.has_projects boolean Optional Whether projects are enabled. default: true
body.has_wiki boolean Optional Whether the wiki is enabled. default: true
body.has_discussions boolean Optional Whether discussions are enabled. default: false
body.team_id integer Optional The id of the team that will be granted access to this repository. This is only valid when creating a repository in an organization.
body.auto_init boolean Optional Whether the repository is initialized with a minimal README. default: false
body.gitignore_template string Optional The desired language or platform to apply to the .gitignore.
body.license_template string Optional The license keyword of the open source license for this repository.
body.allow_squash_merge boolean Optional Whether to allow squash merges for pull requests. default: true
body.allow_merge_commit boolean Optional Whether to allow merge commits for pull requests. default: true
body.allow_rebase_merge boolean Optional Whether to allow rebase merges for pull requests. default: true
body.allow_auto_merge boolean Optional Whether to allow Auto-merge to be used on pull requests. default: false
body.delete_branch_on_merge boolean Optional Whether to delete head branches when pull requests are merged default: false
body.squash_merge_commit_title string Optional Required when using squash_merge_commit_message. The default value for a squash merge commit title: - PR_TITLE - default to the pull request's title. - COMMIT_OR_PR_TITLE - default to the commit's title (if only one commit) or the pull request's title (when more than one commit). enum: ["PR_TITLE","COMMIT_OR_PR_TITLE"]
body.squash_merge_commit_message string Optional The default value for a squash merge commit message: - PR_BODY - default to the pull request's body. - COMMIT_MESSAGES - default to the branch's commit messages. - BLANK - default to a blank commit message. enum: ["PR_BODY","COMMIT_MESSAGES","BLANK"]
body.merge_commit_title string Optional Required when using merge_commit_message. The default value for a merge commit title. - PR_TITLE - default to the pull request's title. - MERGE_MESSAGE - default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name). enum: ["PR_TITLE","MERGE_MESSAGE"]
body.merge_commit_message string Optional The default value for a merge commit message. - PR_TITLE - default to the pull request's title. - PR_BODY - default to the pull request's body. - BLANK - default to a blank commit message. enum: ["PR_BODY","PR_TITLE","BLANK"]
body.has_downloads boolean Optional Whether downloads are enabled. default: true
body.is_template boolean Optional Whether this repository acts as a template that can be used to generate new repositories. default: false

Full JSON Schema

Full JSON Schema

Example input

{
  "body": {
    "name": "Hello-World",
    "description": "This is your first repo!",
    "homepage": "https://github.com",
    "private": false,
    "is_template": true
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repository invitations for the authenticated user — github.repos.list-invitations-for-authenticated-user

Run List repository invitations for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Accept a repository invitation — github.repos.accept-invitation-for-authenticated-user

Run Accept a repository invitation with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.invitation_id integer Required The unique identifier of the invitation.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "invitation_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Decline a repository invitation — github.repos.decline-invitation-for-authenticated-user

Run Decline a repository invitation with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.invitation_id integer Required The unique identifier of the invitation.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "invitation_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List social accounts for the authenticated user — github.users.list-social-accounts-for-authenticated-user

Run List social accounts for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add social accounts for the authenticated user — github.users.add-social-account-for-authenticated-user

Run Add social accounts for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
body object Required
body.account_urls array Required Full URLs for the social media profiles to add.
body.account_urls[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "body": {
    "account_urls": [
      "https://facebook.com/GitHub",
      "https://www.youtube.com/@GitHub"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete social accounts for the authenticated user — github.users.delete-social-account-for-authenticated-user

Run Delete social accounts for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
body object Required
body.account_urls array Required Full URLs for the social media profiles to delete.
body.account_urls[] string Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "body": {
    "account_urls": [
      "https://facebook.com/GitHub",
      "https://www.youtube.com/@GitHub"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List SSH signing keys for the authenticated user — github.users.list-ssh-signing-keys-for-authenticated-user

Run List SSH signing keys for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an SSH signing key for the authenticated user — github.users.get-ssh-signing-key-for-authenticated-user

Run Get an SSH signing key for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.ssh_signing_key_id integer Required The unique identifier of the SSH signing key.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "ssh_signing_key_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete an SSH signing key for the authenticated user — github.users.delete-ssh-signing-key-for-authenticated-user

Run Delete an SSH signing key for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.ssh_signing_key_id integer Required The unique identifier of the SSH signing key.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "ssh_signing_key_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repositories starred by the authenticated user — github.activity.list-repos-starred-by-authenticated-user

Run List repositories starred by the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.sort string Optional The property to sort the results by. created means when the repository was starred. updated means when the repository was last pushed to. enum: ["created","updated"]; default: "created"
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check if a repository is starred by the authenticated user — github.activity.check-repo-is-starred-by-authenticated-user

Run Check if a repository is starred by the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Star a repository for the authenticated user — github.activity.star-repo-for-authenticated-user

Run Star a repository for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Unstar a repository for the authenticated user — github.activity.unstar-repo-for-authenticated-user

Run Unstar a repository for the authenticated user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.owner string Required The account owner of the repository. The name is not case sensitive.
path.repo string Required The name of the repository without the .git extension. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "owner": "octocat",
    "repo": "hello-world"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repositories watched by the authenticated user — github.activity.list-watched-repos-for-authenticated-user

Run List repositories watched by the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

List teams for the authenticated user — github.teams.list-for-authenticated-user

Run List teams for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a user using their ID — github.users.get-by-id

Run Get a user using their ID with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.account_id integer Required account_id parameter

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "account_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create draft item for user owned project — github.projects.create-draft-item-for-authenticated-user

Run Create draft item for user owned project with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.user_id string Required The unique identifier of the user.
path.project_number integer Required The project's number.
body object Required
body.title string Required The title of the draft issue item to create in the project.
body.body string Optional The body content of the draft issue item to create in the project.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "user_id": "example",
    "project_number": 1
  },
  "body": {
    "title": "Sample Draft Issue Title"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List users — github.users.list

Run List users with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.since integer Optional A user ID. Only return users with an ID greater than this ID.
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a view for a user-owned project — github.projects.create-view-for-user

Run Create a view for a user-owned project with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.user_id string Required The unique identifier of the user.
path.project_number integer Required The project's number.
body object Required additionalProperties: false
body.name string Required The name of the view.
body.layout string Required The layout of the view. enum: ["table","board","roadmap"]
body.filter string Optional The filter query for the view. See Filtering projects for more information.
body.visible_fields array Optional visible_fields is not applicable to roadmap layout views. For table and board layouts, this represents the field IDs that should be visible in the view. If not provided, the default visible fields will be used.
body.visible_fields[] integer Optional
body.sort_by array Optional Sorting configuration for the view. Each element is a two-element array of [field_id, direction] where direction is "asc" or "desc". Supports multiple sort criteria applied in order.
body.sort_by[] array Optional minItems: 2; maxItems: 2
body.sort_by[][] — Optional
body.sort_by[][] integer Optional oneOf[1]
body.sort_by[][] string Optional oneOf[2]
body.group_by array Optional The field IDs to group items by (horizontal grouping). Supports a single field. The field must support grouping; fields such as Title, Reviewers, Linked pull requests, Sub-issues progress, Tracked by, and Tracks cannot be grouped on. maxItems: 1
body.group_by[] integer Optional
body.vertical_group_by array Optional The field IDs to use as columns in board layout (vertical grouping). Supports a single field. The field must support grouping; fields such as Title, Reviewers, Linked pull requests, Sub-issues progress, Tracked by, and Tracks cannot be grouped on. maxItems: 1
body.vertical_group_by[] integer Optional

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "user_id": "example",
    "project_number": 1
  },
  "body": {
    "name": "All Issues",
    "layout": "table",
    "filter": "is:issue",
    "visible_fields": [
      123,
      456,
      789
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a user — github.users.get-by-username

Run Get a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List attestations by bulk subject digests — github.users.list-attestations-bulk

Run List attestations by bulk subject digests with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
body object Required
body.subject_digests array Required List of subject digests to fetch attestations for. minItems: 1; maxItems: 1024
body.subject_digests[] string Optional
body.predicate_type string Optional Optional filter for fetching attestations with a given predicate type. This option accepts provenance, sbom, release, or freeform text for custom predicate types.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  },
  "body": {
    "subject_digests": [
      "example"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete attestations in bulk — github.users.delete-attestations-bulk

Run Delete attestations in bulk with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
body object Required The request body must include either subject_digests or attestation_ids, but not both.
body object Required oneOf[1]
body.subject_digests array Required List of subject digests associated with the artifact attestations to delete. oneOf[1]; minItems: 1; maxItems: 1024
body.subject_digests[] string Optional oneOf[1]
body object Required oneOf[2]
body.attestation_ids array Required List of unique IDs associated with the artifact attestations to delete. oneOf[2]; minItems: 1; maxItems: 1024
body.attestation_ids[] integer Optional oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  },
  "body": {
    "subject_digests": [
      "sha256:abc123",
      "sha512:def456"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete attestations by subject digest — github.users.delete-attestations-by-subject-digest

Run Delete attestations by subject digest with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.subject_digest string Required Subject Digest

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "subject_digest": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete attestations by ID — github.users.delete-attestations-by-id

Run Delete attestations by ID with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.attestation_id integer Required Attestation ID

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "attestation_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List attestations — github.users.list-attestations

Run List attestations with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.predicate_type string Optional Optional filter for fetching attestations with a given predicate type. This option accepts provenance, sbom, release, or freeform text for custom predicate types.
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.subject_digest string Required Subject Digest

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "subject_digest": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List Copilot Spaces for a user — github.copilot-spaces.list-for-user

Run List Copilot Spaces for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). default: 30; minimum: 1; maximum: 100
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor.
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a Copilot Space for a user — github.copilot-spaces.create-for-user

Run Create a Copilot Space for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
body object Required
body.name string Required The name of the Copilot Space.
body.description string Optional A description of the Copilot Space.
body.general_instructions string Optional General instructions for the Copilot Space. maxLength: 4000
body.base_role string Optional The base role that determines default permissions for the space. - no_access: No default access (default) - reader: Makes the space publicly readable Note: User spaces do not support writer or admin base roles. enum: ["reader","no_access"]; default: "no_access"
body.resources_attributes array Optional Resources to attach to the space.
body.resources_attributes[] object Optional
body.resources_attributes[].resource_type string Optional The type of resource. enum: ["repository","github_file","free_text","github_issue","github_pull_request","media_content","uploaded_text_file"]
body.resources_attributes[].metadata object Optional Metadata specific to the resource type.
body.resources_attributes[].metadata.repository_id integer Optional Repository ID for repository or file resources.
body.resources_attributes[].metadata.file_path string Optional File path for file resources.
body.resources_attributes[].metadata.text string Optional Text content for free text resources.
body.resources_attributes[].metadata.name string Optional Name for the resource.
body.resources_attributes[].metadata.number integer Optional Issue or PR number.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  },
  "body": {
    "name": "My Development Space",
    "description": "Personal space for development assistance",
    "general_instructions": "Help me with React development patterns and best practices",
    "resources_attributes": [
      {
        "resource_type": "github_file",
        "metadata": {
          "repository_id": 789012,
          "file_path": "src/components/App.js"
        }
      },
      {
        "resource_type": "free_text",
        "metadata": {
          "name": "Development Notes",
          "text": "Focus on clean code principles and modern React patterns"
        }
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a Copilot Space for a user — github.copilot-spaces.get-for-user

Run Get a Copilot Space for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.space_number integer Required The unique identifier of the Copilot Space.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "space_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set a Copilot Space for a user — github.copilot-spaces.update-for-user

Run Set a Copilot Space for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.space_number integer Required The unique identifier of the Copilot Space.
body object Required
body.name string Optional The name of the Copilot Space.
body.description string Optional A description of the Copilot Space.
body.general_instructions string Optional General instructions for the Copilot Space. maxLength: 4000
body.base_role string Optional The base role that determines default permissions for the space. Changing this field requires admin permissions. - no_access: No default access (default) - reader: Makes the space publicly readable Note: User spaces do not support writer or admin base roles. enum: ["reader","no_access"]
body.resources_attributes array Optional Resources to attach to the space.
body.resources_attributes[] object Optional
body.resources_attributes[].resource_type string Optional The type of resource. enum: ["repository","github_file","free_text","github_issue","github_pull_request","media_content","uploaded_text_file"]
body.resources_attributes[].metadata object Optional Metadata specific to the resource type.
body.resources_attributes[].metadata.repository_id integer Optional Repository ID for repository or file resources.
body.resources_attributes[].metadata.file_path string Optional File path for file resources.
body.resources_attributes[].metadata.text string Optional Text content for free text resources.
body.resources_attributes[].metadata.name string Optional Name for the resource.
body.resources_attributes[].metadata.number integer Optional Issue or PR number.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "space_number": 1
  },
  "body": {
    "name": "Updated Development Space",
    "description": "Updated personal space for development assistance",
    "general_instructions": "Updated instructions to help me with React development patterns and best practices",
    "resources_attributes": [
      {
        "resource_type": "github_file",
        "metadata": {
          "repository_id": 789012,
          "file_path": "src/components/UpdatedApp.js"
        }
      },
      {
        "id": 123,
        "_destroy": true
      },
      {
        "id": 456,
        "resource_type": "free_text",
        "metadata": {
          "name": "Updated Development Notes",
          "text": "Updated focus on clean code principles and modern React patterns"
        }
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a Copilot Space for a user — github.copilot-spaces.delete-for-user

Run Delete a Copilot Space for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.space_number integer Required The unique identifier of the Copilot Space.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "space_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List collaborators for a Copilot Space for a user — github.copilot-spaces.list-collaborators-for-user

Run List collaborators for a Copilot Space for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.space_number integer Required The unique identifier of the Copilot Space.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "space_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add a collaborator to a Copilot Space for a user — github.copilot-spaces.add-collaborator-for-user

Run Add a collaborator to a Copilot Space for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.space_number integer Required The unique identifier of the Copilot Space.
body object Required
body.actor_type string Required The type of actor (must be User for user-owned spaces; Team will be rejected). enum: ["User","Team"]
body.actor_identifier string Required The username of the collaborator. The numeric user ID is also accepted.
body.role string Required The role to grant to the collaborator. enum: ["reader","writer","admin"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "space_number": 1
  },
  "body": {
    "actor_type": "User",
    "actor_identifier": "octocat",
    "role": "writer"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set a collaborator role for a Copilot Space for a user — github.copilot-spaces.update-collaborator-for-user

Run Set a collaborator role for a Copilot Space for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.space_number integer Required The unique identifier of the Copilot Space.
path.actor_type string Required The type of actor (must be User for user-owned spaces; Team will be rejected). enum: ["User","Team"]
path.actor_identifier string Required The username of the collaborator. The numeric user ID is also accepted.
body object Required
body.role string Required The new role to grant to the collaborator. Use no_access to remove the collaborator. enum: ["reader","writer","admin","no_access"]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "space_number": 1,
    "actor_type": "User",
    "actor_identifier": "example"
  },
  "body": {
    "role": "admin"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Remove a collaborator from a Copilot Space for a user — github.copilot-spaces.remove-collaborator-for-user

Run Remove a collaborator from a Copilot Space for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.space_number integer Required The unique identifier of the Copilot Space.
path.actor_type string Required The type of actor (must be User for user-owned spaces; Team will be rejected). enum: ["User","Team"]
path.actor_identifier string Required The username of the collaborator. The numeric user ID is also accepted.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "space_number": 1,
    "actor_type": "User",
    "actor_identifier": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List resources for a Copilot Space for a user — github.copilot-spaces.list-resources-for-user

Run List resources for a Copilot Space for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.space_number integer Required The unique identifier of the Copilot Space.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "space_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Create a resource for a Copilot Space for a user — github.copilot-spaces.create-resource-for-user

Run Create a resource for a Copilot Space for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.space_number integer Required The unique identifier of the Copilot Space.
body object Required
body.resource_type string Required The type of resource to create. enum: ["repository","github_file","free_text","github_issue","github_pull_request"]
body.metadata object Required Resource-specific metadata. additionalProperties: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "space_number": 1
  },
  "body": {
    "resource_type": "free_text",
    "metadata": {
      "name": "notes.txt",
      "text": "Some helpful notes"
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a resource for a Copilot Space for a user — github.copilot-spaces.get-resource-for-user

Run Get a resource for a Copilot Space for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.space_number integer Required The unique identifier of the Copilot Space.
path.space_resource_id integer Required The unique identifier of the resource.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "space_number": 1,
    "space_resource_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Set a resource for a Copilot Space for a user — github.copilot-spaces.update-resource-for-user

Run Set a resource for a Copilot Space for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.space_number integer Required The unique identifier of the Copilot Space.
path.space_resource_id integer Required The unique identifier of the resource.
body object Required
body.metadata object Optional Updated resource-specific metadata. additionalProperties: true

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "space_number": 1,
    "space_resource_id": 1
  },
  "body": {
    "metadata": {
      "name": "updated-notes.txt",
      "text": "Updated content"
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a resource from a Copilot Space for a user — github.copilot-spaces.delete-resource-for-user

Run Delete a resource from a Copilot Space for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.space_number integer Required The unique identifier of the Copilot Space.
path.space_resource_id integer Required The unique identifier of the resource.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "space_number": 1,
    "space_resource_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get list of conflicting packages during Docker migration for user — github.packages.list-docker-migration-conflicting-packages-for-user

Run Get list of conflicting packages during Docker migration for user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List events for the authenticated user — github.activity.list-events-for-authenticated-user

Run List events for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organization events for the authenticated user — github.activity.list-org-events-for-authenticated-user

Run List organization events for the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.org string Required The organization name. The name is not case sensitive.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "org": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List public events for a user — github.activity.list-public-events-for-user

Run List public events for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List followers of a user — github.users.list-followers-for-user

Run List followers of a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List the people a user follows — github.users.list-following-for-user

Run List the people a user follows with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Check if a user follows another user — github.users.check-following-for-user

Run Check if a user follows another user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.target_user string Required

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "target_user": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List gists for a user — github.gists.list-for-user

Run List gists for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.since string Optional Only show results that were last updated after the given time. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. format: "date-time"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List GPG keys for a user — github.users.list-gpg-keys-for-user

Run List GPG keys for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get contextual information for a user — github.users.get-context-for-user

Run Get contextual information for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.subject_type string Optional Identifies which additional information you'd like to receive about the person's hovercard. Can be organization, repository, issue, pull_request. Required when using subject_id. enum: ["organization","repository","issue","pull_request"]
query.subject_id string Optional Uses the ID for the subject_type you specified. Required when using subject_type.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a user installation for the authenticated app — github.apps.get-user-installation

Run Get a user installation for the authenticated app with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List public keys for a user — github.users.list-public-keys-for-user

Run List public keys for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List organizations for a user — github.orgs.list-for-user

Run List organizations for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List packages for a user — github.packages.list-packages-for-user

Run List packages for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
query object Required additionalProperties: false
query.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
query.visibility string Optional The selected visibility of the packages. This parameter is optional and only filters an existing result set. The internal visibility is only supported for GitHub Packages registries that allow for granular permissions. For other ecosystems internal is synonymous with private. For the list of GitHub Packages registries that support granular permissions, see "About permissions for GitHub Packages." enum: ["public","private","internal"]
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "package_type": "npm"
  },
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a package for a user — github.packages.get-package-for-user

Run Get a package for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete a package for a user — github.packages.delete-package-for-user

Run Delete a package for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Restore a package for a user — github.packages.restore-package-for-user

Run Restore a package for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.token string Optional package token

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List package versions for a package owned by a user — github.packages.get-all-package-versions-for-package-owned-by-user

Run List package versions for a package owned by a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example",
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get a package version for a user — github.packages.get-package-version-for-user

Run Get a package version for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
path.package_version_id integer Required Unique identifier of the package version.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example",
    "package_version_id": 1,
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete package version for a user — github.packages.delete-package-version-for-user

Run Delete package version for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
path.username string Required The handle for the GitHub user account.
path.package_version_id integer Required Unique identifier of the package version.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example",
    "username": "example",
    "package_version_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Restore package version for a user — github.packages.restore-package-version-for-user

Run Restore package version for a user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.package_type string Required The type of supported package. Packages in GitHub's Gradle registry have the type maven. Docker images pushed to GitHub's Container registry (ghcr.io) have the type container. You can use the type docker to find images that were pushed to GitHub's Docker registry (docker.pkg.github.com), even if these have now been migrated to the Container registry. enum: ["npm","maven","rubygems","docker","nuget","container"]
path.package_name string Required The name of the package.
path.username string Required The handle for the GitHub user account.
path.package_version_id integer Required Unique identifier of the package version.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "package_type": "npm",
    "package_name": "example",
    "username": "example",
    "package_version_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List projects for user — github.projects.list-for-user

Run List projects for user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.q string Optional Limit results to projects of the specified type.
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get project for user — github.projects.get-for-user

Run Get project for user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.project_number integer Required The project's number.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "project_number": 1,
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List project fields for user — github.projects.list-fields-for-user

Run List project fields for user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.project_number integer Required The project's number.
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "project_number": 1,
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add field to user owned project — github.projects.add-field-for-user

Run Add field to user owned project with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.project_number integer Required The project's number.
body — Required
body object Required oneOf[1]; additionalProperties: false
body.name string Required The name of the field. oneOf[1]
body.data_type string Required The field's data type. oneOf[1]; enum: ["text","number","date"]
body object Required oneOf[2]; additionalProperties: false
body.name string Required The name of the field. oneOf[2]
body.data_type string Required The field's data type. oneOf[2]; enum: ["single_select"]
body.single_select_options array Required The options available for single select fields. At least one option must be provided when creating a single select field. oneOf[2]
body.single_select_options[] — Optional oneOf[2]; $ref: "#/definitions/projects-v2-field-single-select-option"
body object Required oneOf[3]; additionalProperties: false
body.name string Required The name of the field. oneOf[3]
body.data_type string Required The field's data type. oneOf[3]; enum: ["iteration"]
body.iteration_configuration — Required oneOf[3]; $ref: "#/definitions/projects-v2-field-iteration-configuration"

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "project_number": 1
  },
  "body": {
    "name": "Team notes",
    "data_type": "text"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get project field for user — github.projects.get-field-for-user

Run Get project field for user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.project_number integer Required The project's number.
path.field_id integer Required The unique identifier of the field.
path.username string Required The handle for the GitHub user account.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "project_number": 1,
    "field_id": 1,
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List items for a user owned project — github.projects.list-items-for-user

Run List items for a user owned project with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.project_number integer Required The project's number.
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.q string Optional Search query to filter items, see Filtering projects for more information.
query.fields — Optional Limit results to specific fields, by their IDs. If not specified, the title field will be returned. Example: fields[]=123&fields[]=456&fields[]=789 or fields=123,456,789
query.fields string Optional oneOf[1]
query.fields array Optional oneOf[2]; maxItems: 50
query.fields[] string Optional oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "project_number": 1,
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Add item to user owned project — github.projects.add-item-for-user

Run Add item to user owned project with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
path.project_number integer Required The project's number.
body object Required additionalProperties: false
body.type string Required The type of item to add to the project. Must be either Issue or PullRequest. enum: ["Issue","PullRequest"]
body.id integer Optional The unique identifier of the issue or pull request to add to the project.
body.owner string Optional The repository owner login.
body.repo string Optional The repository name.
body.number integer Optional The issue or pull request number.
body — Required oneOf[1]
body — Required oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example",
    "project_number": 1
  },
  "body": {
    "type": "Issue",
    "id": 3
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get an item for a user owned project — github.projects.get-user-item

Run Get an item for a user owned project with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.project_number integer Required The project's number.
path.username string Required The handle for the GitHub user account.
path.item_id integer Required The unique identifier of the project item.
query object Optional additionalProperties: false
query.fields — Optional Limit results to specific fields, by their IDs. If not specified, the title field will be returned. Example: fields[]=123&fields[]=456&fields[]=789 or fields=123,456,789
query.fields string Optional oneOf[1]
query.fields array Optional oneOf[2]; maxItems: 50
query.fields[] string Optional oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "project_number": 1,
    "username": "example",
    "item_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Update project item for user — github.projects.update-item-for-user

Run Update project item for user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.project_number integer Required The project's number.
path.username string Required The handle for the GitHub user account.
path.item_id integer Required The unique identifier of the project item.
body object Required
body.fields array Required A list of field updates to apply.
body.fields[] object Optional
body.fields[].id integer Required The ID of the project field to update.
body.fields[].value — Required The new value for the field: - For text, number, and date fields, provide the new value directly. - For single select and iteration fields, provide the ID of the option or iteration. - To clear the field, set this to null.
body.fields[].value string Required oneOf[1]
body.fields[].value number Required oneOf[2]

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "project_number": 1,
    "username": "example",
    "item_id": 1
  },
  "body": {
    "fields": [
      {
        "id": 123,
        "value": "Updated text value"
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Delete project item for user — github.projects.delete-item-for-user

Run Delete project item for user with GitHub. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.project_number integer Required The project's number.
path.username string Required The handle for the GitHub user account.
path.item_id integer Required The unique identifier of the project item.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "project_number": 1,
    "username": "example",
    "item_id": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List items for a user project view — github.projects.list-view-items-for-user

Run List items for a user project view with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.project_number integer Required The project's number.
path.username string Required The handle for the GitHub user account.
path.view_number integer Required The number that identifies the project view.
query object Optional additionalProperties: false
query.fields — Optional Limit results to specific fields, by their IDs. If not specified, the title field will be returned. Example: fields[]=123&fields[]=456&fields[]=789 or fields=123,456,789
query.fields string Optional oneOf[1]
query.fields array Optional oneOf[2]; maxItems: 50
query.fields[] string Optional oneOf[2]
query.before string Optional A cursor, as given in the Link header. If specified, the query only searches for results before this cursor. For more information, see "Using pagination in the REST API."
query.after string Optional A cursor, as given in the Link header. If specified, the query only searches for results after this cursor. For more information, see "Using pagination in the REST API."
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "project_number": 1,
    "username": "example",
    "view_number": 1
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List events received by the authenticated user — github.activity.list-received-events-for-user

Run List events received by the authenticated user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List public events received by a user — github.activity.list-received-public-events-for-user

Run List public events received by a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repositories for a user — github.repos.list-for-user

Run List repositories for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.type string Optional Limit results to repositories of the specified type. enum: ["all","owner","member"]; default: "owner"
query.sort string Optional The property to sort the results by. enum: ["created","updated","pushed","full_name"]; default: "full_name"
query.direction string Optional The order to sort by. Default: asc when using full_name, otherwise desc. enum: ["asc","desc"]
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get billing AI credit usage report for a user — github.billing.get-github-billing-ai-credit-usage-report-user

Run Get billing AI credit usage report for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.year integer Optional If specified, only return results for a single year. The value of year is an integer with four digits representing a year. For example, 2025. Default value is the current year.
query.month integer Optional If specified, only return results for a single month. The value of month is an integer between 1 and 12. Default value is the current month. If no year is specified the default year is used.
query.day integer Optional If specified, only return results for a single day. The value of day is an integer between 1 and 31. If no year or month is specified, the default year and month are used.
query.model string Optional The model name to query usage for. The name is not case sensitive.
query.product string Optional The product name to query usage for. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get billing premium request usage report for a user — github.billing.get-github-billing-premium-request-usage-report-user

Run Get billing premium request usage report for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.year integer Optional If specified, only return results for a single year. The value of year is an integer with four digits representing a year. For example, 2025. Default value is the current year.
query.month integer Optional If specified, only return results for a single month. The value of month is an integer between 1 and 12. Default value is the current month. If no year is specified the default year is used.
query.day integer Optional If specified, only return results for a single day. The value of day is an integer between 1 and 31. If no year or month is specified, the default year and month are used.
query.model string Optional The model name to query usage for. The name is not case sensitive.
query.product string Optional The product name to query usage for. The name is not case sensitive.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get billing usage report for a user — github.billing.get-github-billing-usage-report-user

Run Get billing usage report for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.year integer Optional If specified, only return results for a single year. The value of year is an integer with four digits representing a year. For example, 2025. Default value is the current year.
query.month integer Optional If specified, only return results for a single month. The value of month is an integer between 1 and 12. If no year is specified the default year is used.
query.day integer Optional If specified, only return results for a single day. The value of day is an integer between 1 and 31. If no year or month is specified, the default year and month are used.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get billing usage summary for a user — github.billing.get-github-billing-usage-summary-report-user

Run Get billing usage summary for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.year integer Optional If specified, only return results for a single year. The value of year is an integer with four digits representing a year. For example, 2025. Default value is the current year.
query.month integer Optional If specified, only return results for a single month. The value of month is an integer between 1 and 12. Default value is the current month. If no year is specified the default year is used.
query.day integer Optional If specified, only return results for a single day. The value of day is an integer between 1 and 31. If no year or month is specified, the default year and month are used.
query.repository string Optional The repository name to query for usage in the format owner/repository.
query.product string Optional The product name to query usage for. The name is not case sensitive.
query.sku string Optional The SKU to query for usage.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List social accounts for a user — github.users.list-social-accounts-for-user

Run List social accounts for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List SSH signing keys for a user — github.users.list-ssh-signing-keys-for-user

Run List SSH signing keys for a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repositories starred by a user — github.activity.list-repos-starred-by-user

Run List repositories starred by a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.sort string Optional The property to sort the results by. created means when the repository was starred. updated means when the repository was last pushed to. enum: ["created","updated"]; default: "created"
query.direction string Optional The direction to sort the results by. enum: ["asc","desc"]; default: "desc"
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

List repositories watched by a user — github.activity.list-repos-watched-by-user

Run List repositories watched by a user with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Parameter Type Required in parent Description Constraints
path object Required additionalProperties: false
path.username string Required The handle for the GitHub user account.
query object Optional additionalProperties: false
query.per_page integer Optional The number of results per page (max 100). For more information, see "Using pagination in the REST API." default: 30
query.page integer Optional The page number of the results to fetch. For more information, see "Using pagination in the REST API." default: 1

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "username": "example"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get all API versions — github.meta.get-all-versions

Run Get all API versions with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Get the Zen of GitHub — github.meta.get-zen

Run Get the Zen of GitHub with GitHub. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Errors

Check the key's expiry, revocation, workspace and allowed operations.

Reuse the same idempotency key only for the same request.

The connection or provider limit has been reached. Check the receipt before retrying.

Test the connection

Open the integration's commands below to inspect parameters and examples. Start with a read command for an account or resource you can access. Refresh your client's tool list, use the returned tool name, and check the execution result and usage. Provider charges and permissions still apply. Never test a write against production data without reviewing it.

Official provider documentation

Type to search…

↑↓ navigate↵ selectEsc close