How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

GitHub Repositories API

The Repositories API from GitHub — 123 operation(s) for repositories.

GitHub Repositories API is one of 350 APIs that GitHub publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Repositories. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, and an API reference.

This API exposes 171 operations across 113 paths, and defines 199 schemas. It is described by OpenAPI 3.2.0, at version 1.1.4.

Requests are made against 2 base URLs: {protocol}://{hostname}/api/v3, {protocol}://{hostname}.

171 operations 113 paths 199 schemas 28 DELETE90 GET9 PATCH18 POST26 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.1.4
Base URL
https://api.github.com
Authentication
HTTP Bearer
License
Terms of Service
Resource Areas
1

Authentication & Security 1

GitHub Repositories API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerHttpAuthentication).

  • bearerHttpAuthentication — Bearer Token

Paths & Operations 171

Across 113 paths, the API surfaces 171 operations — 28 DELETE, 90 GET, 9 PATCH, 18 POST, 26 PUT. Each is listed below with its method, path, parameters, and response codes.

Repositories 171
GET
/installation/repositories
GitHub List Repositories Accessible to the App Installation
listRepositoriesAccessibleToTheAppInstallation 2 params → 200304401403
GET
/repos/{owner}/{repo}/installation
GitHub Get Repository Installation for the Authenticated App
getrepositoryInstallationForTheAuthenticatedApp 2 params → 200301404
GET
/user/installations/{installation_id}/repositories
GitHub List Repositories Accessible to the User Access Token
listRepositoriesAccessibleToTheUserAccessToken 3 params → 200304403404
PUT
/user/installations/{installation_id}/repositories/{repository_id}
GitHub Add Repository to an App Installation
addrepositoryToAnAppInstallation 2 params → 204304403404
DELETE
/user/installations/{installation_id}/repositories/{repository_id}
GitHub Remove Repository from an App Installation
removerepositoryFromAnAppInstallation 2 params → 204304403404
GET
/networks/{owner}/{repo}/events
GitHub List Public Events for Network of Repositories
listPublicEventsForNetworkOfRepositories 4 params → 200301304403404
GET
/organizations/{organization_id}/custom_rolesdeprecated
GitHub Deprecated - List Custom Repository Roles in an Organization
deprecatedListCustomRepositoryRolesInAnOrganization 1 param → 200
GET
/orgs/{org}/actions/cache/usage-by-repository
GitHub List Repositories with Github Actions Cache Usage for an Organization
listRepositoriesWithGithubActionsCacheUsageForAnOrganization 3 params → 200
GET
/orgs/{org}/actions/permissions/repositories
GitHub List Selected Repositories Enabled for Github Actions in an Organization
listSelectedRepositoriesEnabledForGithubActionsInAnOrganization 3 params → 200
PUT
/orgs/{org}/actions/permissions/repositories
GitHub Set Selected Repositories Enabled for Github Actions in an Organization
setSelectedRepositoriesEnabledForGithubActionsInAnOrganization 1 param body → 204
PUT
/orgs/{org}/actions/permissions/repositories/{repository_id}
GitHub Enable Selected Repository for Github Actions in an Organization
enableSelectedRepositoryForGithubActionsInAnOrganization 2 params → 204
DELETE
/orgs/{org}/actions/permissions/repositories/{repository_id}
GitHub Disable Selected Repository for Github Actions in an Organization
disableSelectedRepositoryForGithubActionsInAnOrganization 2 params → 204
GET
/orgs/{org}/actions/runner-groups/{runner_group_id}/repositories
GitHub List Repository Access to Self-hosted Runner Group in an Organization
listRepositoryAccessToSelfhostedRunnerGroupInAnOrganization 4 params → 200
PUT
/orgs/{org}/actions/runner-groups/{runner_group_id}/repositories
GitHub Set Repository Access for Self-hosted Runner Group in an Organization
setRepositoryAccessForSelfhostedRunnerGroupInAnOrganization 2 params body → 204
PUT
/orgs/{org}/actions/runner-groups/{runner_group_id}/repositories/{repository_id}
GitHub Add Repository Access to Self-hosted Runner Group in an Organization
addRepositoryAccessToSelfhostedRunnerGroupInAnOrganization 3 params → 204
DELETE
/orgs/{org}/actions/runner-groups/{runner_group_id}/repositories/{repository_id}
GitHub Remove Repository Access to Self-hosted Runner Group in an Organization
removeRepositoryAccessToSelfhostedRunnerGroupInAnOrganization 3 params → 204
GET
/orgs/{org}/actions/secrets/{secret_name}/repositories
GitHub List Selected Repositories for an Organization Secret
listSelectedRepositoriesForAnOrganizationSecret 4 params → 200
PUT
/orgs/{org}/actions/secrets/{secret_name}/repositories
GitHub Set Selected Repositories for an Organization Secret
setSelectedRepositoriesForAnOrganizationSecret 2 params body → 204
PUT
/orgs/{org}/actions/secrets/{secret_name}/repositories/{repository_id}
GitHub Add Selected Repository to an Organization Secret
addSelectedRepositoryToAnOrganizationSecret 3 params → 204409
DELETE
/orgs/{org}/actions/secrets/{secret_name}/repositories/{repository_id}
GitHub Remove Selected Repository from an Organization Secret
removeSelectedRepositoryFromAnOrganizationSecret 3 params → 204409
GET
/orgs/{org}/actions/variables/{name}/repositories
GitHub List Selected Repositories for an Organization Variable
listSelectedRepositoriesForAnOrganizationVariable 4 params → 200409
PUT
/orgs/{org}/actions/variables/{name}/repositories
GitHub Set Selected Repositories for an Organization Variable
setSelectedRepositoriesForAnOrganizationVariable 2 params body → 204409
PUT
/orgs/{org}/actions/variables/{name}/repositories/{repository_id}
GitHub Add Selected Repository to an Organization Variable
addSelectedRepositoryToAnOrganizationVariable 3 params → 204409
DELETE
/orgs/{org}/actions/variables/{name}/repositories/{repository_id}
GitHub Remove Selected Repository from an Organization Variable
removeSelectedRepositoryFromAnOrganizationVariable 3 params → 204409
GET
/orgs/{org}/custom-repository-roles
GitHub List Custom Repository Roles in an Organization
listCustomRepositoryRolesInAnOrganization 1 param → 200
POST
/orgs/{org}/custom-repository-roles
GitHub Create Custom Repository Role
createCustomRepositoryRole 1 param body → 201404422
GET
/orgs/{org}/custom-repository-roles/{role_id}
GitHub Get Custom Repository Role
getCustomRepositoryRole 2 params → 200404
PATCH
/orgs/{org}/custom-repository-roles/{role_id}
GitHub Update Custom Repository Role
updateCustomRepositoryRole 2 params body → 200404422
DELETE
/orgs/{org}/custom-repository-roles/{role_id}
GitHub Delete Custom Repository Role
deleteCustomRepositoryRole 2 params → 204
GET
/orgs/{org}/dependabot/secrets/{secret_name}/repositories
GitHub List Selected Repositories for an Organization Secret
listSelectedRepositoriesForAnOrganizationSecret 4 params → 200
PUT
/orgs/{org}/dependabot/secrets/{secret_name}/repositories
GitHub Set Selected Repositories for an Organization Secret
setSelectedRepositoriesForAnOrganizationSecret 2 params body → 204
PUT
/orgs/{org}/dependabot/secrets/{secret_name}/repositories/{repository_id}
GitHub Add Selected Repository to an Organization Secret
addSelectedRepositoryToAnOrganizationSecret 3 params → 204409
DELETE
/orgs/{org}/dependabot/secrets/{secret_name}/repositories/{repository_id}
GitHub Remove Selected Repository from an Organization Secret
removeSelectedRepositoryFromAnOrganizationSecret 3 params → 204409
DELETE
/orgs/{org}/migrations/{migration_id}/repos/{repo_name}/lock
GitHub Unlock an Organization Repository
unlockAnOrganizationRepository 3 params → 204404
GET
/orgs/{org}/migrations/{migration_id}/repositories
GitHub List Repositories in an Organization Migration
listRepositoriesInAnOrganizationMigration 4 params → 200404
GET
/orgs/{org}/repos
GitHub List Organization Repositories
listOrganizationRepositories 6 params → 200
POST
/orgs/{org}/repos
GitHub Create an Organization Repository
createAnOrganizationRepository 1 param body → 201403422
GET
/orgs/{org}/repository-fine-grained-permissions
GitHub List Repository Fine-grained Permissions for an Organization
listRepositoryFinegrainedPermissionsForAnOrganization 1 param → 200
GET
/orgs/{org}/teams/{team_slug}/repos
GitHub List Team Repositories
listTeamRepositories 4 params → 200
GET
/orgs/{org}/teams/{team_slug}/repos/{owner}/{repo}
GitHub Check Team Permissions for Repository
checkTeamPermissionsForRepository 4 params → 200204404
PUT
/orgs/{org}/teams/{team_slug}/repos/{owner}/{repo}
GitHub Add or Update Team Repository Permissions
addOrUpdateTeamRepositoryPermissions 4 params body → 204
DELETE
/orgs/{org}/teams/{team_slug}/repos/{owner}/{repo}
GitHub Remove Repository from Team
removeRepositoryFromTeam 4 params → 204
GET
/repos/{owner}/{repo}/projects
GitHub List Repository Projects
listRepositoryProjects 5 params → 200401403404410422
POST
/repos/{owner}/{repo}/projects
GitHub Create Repository Project
createRepositoryProject 2 params body → 201401403404410422
GET
/repos/{owner}/{repo}/actions/artifacts
GitHub List Artifacts for Repository
listArtifactsForRepository 8 params → 200
GET
/repos/{owner}/{repo}/actions/cache/usage
GitHub Get Github Actions Cache Usage for Repository
getGithubActionsCacheUsageForRepository 5 params → 200
GET
/repos/{owner}/{repo}/actions/cache/usage-policy
GitHub Get Github Actions Cache Usage Policy for Repository
getGithubActionsCacheUsagePolicyForRepository 5 params → 200
PATCH
/repos/{owner}/{repo}/actions/cache/usage-policy
GitHub Set Github Actions Cache Usage Policy for Repository
setGithubActionsCacheUsagePolicyForRepository 5 params body → 204
GET
/repos/{owner}/{repo}/actions/caches
GitHub List Github Actions Caches for Repository
listGithubActionsCachesForRepository 11 params → 200
DELETE
/repos/{owner}/{repo}/actions/caches
GitHub Delete Github Actions Caches for Repository (using Cache Key)
deleteGithubActionsCachesForRepositoryUsingCacheKey 7 params → 200
DELETE
/repos/{owner}/{repo}/actions/caches/{cache_id}
GitHub Delete Github Actions Cache for Repository (using Cache Id)
deleteGithubActionsCacheForRepositoryUsingCacheId 6 params → 204
GET
/repos/{owner}/{repo}/actions/oidc/customization/sub
GitHub Get the Customization Template for an Oidc Subject Claim for Repository
getTheCustomizationTemplateForAnOidcSubjectClaimForRepository 5 params → 200400404
PUT
/repos/{owner}/{repo}/actions/oidc/customization/sub
GitHub Set the Customization Template for an Oidc Subject Claim for Repository
setTheCustomizationTemplateForAnOidcSubjectClaimForRepository 5 params body → 201400404422
GET
/repos/{owner}/{repo}/actions/organization-secrets
GitHub List Repository Organization Secrets
listRepositoryOrganizationSecrets 7 params → 200
GET
/repos/{owner}/{repo}/actions/organization-variables
GitHub List Repository Organization Variables
listRepositoryOrganizationVariables 7 params → 200
GET
/repos/{owner}/{repo}/actions/permissions
GitHub Get Github Actions Permissions for Repository
getGithubActionsPermissionsForRepository 5 params → 200
PUT
/repos/{owner}/{repo}/actions/permissions
GitHub Set Github Actions Permissions for Repository
setGithubActionsPermissionsForRepository 5 params body → 204
GET
/repos/{owner}/{repo}/actions/permissions/access
GitHub Get the Level of Access for Workflows Outside of the Repository
getTheLevelOfAccessForWorkflowsOutsideOfTheRepository 5 params → 200
PUT
/repos/{owner}/{repo}/actions/permissions/access
GitHub Set the Level of Access for Workflows Outside of the Repository
setTheLevelOfAccessForWorkflowsOutsideOfTheRepository 5 params body → 204
GET
/repos/{owner}/{repo}/actions/permissions/selected-actions
GitHub Get Allowed Actions for Repository
getAllowedActionsForRepository 5 params → 200
PUT
/repos/{owner}/{repo}/actions/permissions/selected-actions
GitHub Set Allowed Actions for Repository
setAllowedActionsForRepository 5 params body → 204
GET
/repos/{owner}/{repo}/actions/permissions/workflow
GitHub Get Default Workflow Permissions for Repository
getDefaultWorkflowPermissionsForRepository 5 params → 200
PUT
/repos/{owner}/{repo}/actions/permissions/workflow
GitHub Set Default Workflow Permissions for Repository
setDefaultWorkflowPermissionsForRepository 5 params body → 204409
GET
/repos/{owner}/{repo}/actions/runners
GitHub List Self-hosted Runners for Repository
listSelfhostedRunnersForRepository 7 params → 200
GET
/repos/{owner}/{repo}/actions/runners/downloads
GitHub List Runner Applications for Repository
listRunnerApplicationsForRepository 5 params → 200
POST
/repos/{owner}/{repo}/actions/runners/registration-token
GitHub Create Registration Token for Repository
createRegistrationTokenForRepository 5 params → 201
POST
/repos/{owner}/{repo}/actions/runners/remove-token
GitHub Create Remove Token for Repository
createRemoveTokenForRepository 5 params → 201
GET
/repos/{owner}/{repo}/actions/runners/{runner_id}
GitHub Get Self-hosted Runner for Repository
getSelfhostedRunnerForRepository 6 params → 200
DELETE
/repos/{owner}/{repo}/actions/runners/{runner_id}
GitHub Delete Self-hosted Runner from Repository
deleteSelfhostedRunnerFromRepository 6 params → 204
GET
/repos/{owner}/{repo}/actions/runners/{runner_id}/labels
GitHub List Labels for Self-hosted Runner for Repository
listLabelsForSelfhostedRunnerForRepository 6 params → 200404
POST
/repos/{owner}/{repo}/actions/runners/{runner_id}/labels
GitHub Add Custom Labels to Self-hosted Runner for Repository
addCustomLabelsToSelfhostedRunnerForRepository 6 params body → 200404422
PUT
/repos/{owner}/{repo}/actions/runners/{runner_id}/labels
GitHub Set Custom Labels for Self-hosted Runner for Repository
setCustomLabelsForSelfhostedRunnerForRepository 6 params body → 200404422
DELETE
/repos/{owner}/{repo}/actions/runners/{runner_id}/labels
GitHub Remove All Custom Labels from Self-hosted Runner for Repository
removeAllCustomLabelsFromSelfhostedRunnerForRepository 6 params → 200404
DELETE
/repos/{owner}/{repo}/actions/runners/{runner_id}/labels/{name}
GitHub Remove Custom Label from Self-hosted Runner for Repository
removeCustomLabelFromSelfhostedRunnerForRepository 7 params → 200404422
GET
/repos/{owner}/{repo}/actions/runs
GitHub List Workflow Runs for Repository
listWorkflowRunsForRepository 15 params → 200
GET
/repos/{owner}/{repo}/actions/secrets
GitHub List Repository Secrets
listRepositorySecrets 7 params → 200
GET
/repos/{owner}/{repo}/actions/secrets/public-key
GitHub Get Repository Public Key
getRepositoryPublicKey 5 params → 200
GET
/repos/{owner}/{repo}/actions/secrets/{secret_name}
GitHub Get Repository Secret
getRepositorySecret 6 params → 200
PUT
/repos/{owner}/{repo}/actions/secrets/{secret_name}
GitHub Create or Update Repository Secret
createOrUpdateRepositorySecret 6 params body → 201204
DELETE
/repos/{owner}/{repo}/actions/secrets/{secret_name}
GitHub Delete Repository Secret
deleteRepositorySecret 6 params → 204
GET
/repos/{owner}/{repo}/actions/variables
GitHub List Repository Variables
listRepositoryVariables 7 params → 200
POST
/repos/{owner}/{repo}/actions/variables
GitHub Create Repository Variable
createRepositoryVariable 5 params body → 201
GET
/repos/{owner}/{repo}/actions/variables/{name}
GitHub Get Repository Variable
getRepositoryVariable 6 params → 200
PATCH
/repos/{owner}/{repo}/actions/variables/{name}
GitHub Update Repository Variable
updateRepositoryVariable 6 params body → 204
DELETE
/repos/{owner}/{repo}/actions/variables/{name}
GitHub Delete Repository Variable
deleteRepositoryVariable 6 params → 204
GET
/repos/{owner}/{repo}/actions/workflows
GitHub List Repository Workflows
listRepositoryWorkflows 7 params → 200
GET
/repos/{owner}/{repo}/autolinks
GitHub Get All Autolinks of Repository
getAllAutolinksOfRepository 5 params → 200
POST
/repos/{owner}/{repo}/autolinks
GitHub Create an Autolink Reference for Repository
createAnAutolinkReferenceForRepository 5 params body → 201422
GET
/repos/{owner}/{repo}/autolinks/{autolink_id}
GitHub Get an Autolink Reference of Repository
getAnAutolinkReferenceOfRepository 6 params → 200404
DELETE
/repos/{owner}/{repo}/autolinks/{autolink_id}
GitHub Delete an Autolink Reference from Repository
deleteAnAutolinkReferenceFromRepository 6 params → 204404
GET
/repos/{owner}/{repo}/code-scanning/alerts
GitHub List Code Scanning Alerts for Repository
listCodeScanningAlertsForRepository 14 params → 200304403404503
GET
/repos/{owner}/{repo}/code-scanning/analyses
GitHub List Code Scanning Analyses for Repository
listCodeScanningAnalysesForRepository 13 params → 200403404503
GET
/repos/{owner}/{repo}/code-scanning/analyses/{analysis_id}
GitHub Get Code Scanning Analysis for Repository
getCodeScanningAnalysisForRepository 6 params → 200403404503
DELETE
/repos/{owner}/{repo}/code-scanning/analyses/{analysis_id}
GitHub Delete Code Scanning Analysis from Repository
deleteCodeScanningAnalysisFromRepository 7 params → 200400403404503
GET
/repos/{owner}/{repo}/collaborators
GitHub List Repository Collaborators
listRepositoryCollaborators 9 params → 200404
GET
/repos/{owner}/{repo}/collaborators/{username}
GitHub Check if User is Repository Collaborator
checkIfUserIsRepositoryCollaborator 6 params → 204404
PUT
/repos/{owner}/{repo}/collaborators/{username}
GitHub Add Repository Collaborator
addRepositoryCollaborator 6 params body → 204403422
DELETE
/repos/{owner}/{repo}/collaborators/{username}
GitHub Remove Repository Collaborator
removeRepositoryCollaborator 6 params → 204403422
GET
/repos/{owner}/{repo}/collaborators/{username}/permission
GitHub Get Repository Permissions for User
getRepositoryPermissionsForUser 6 params → 200404
GET
/repos/{owner}/{repo}/dependabot/alerts
GitHub List Dependabot Alerts for Repository
listDependabotAlertsForRepository 19 params → 200304400403404422
GET
/repos/{owner}/{repo}/dependabot/secrets
GitHub List Repository Secrets
listRepositoryDependabotSecrets 7 params → 200
GET
/repos/{owner}/{repo}/dependabot/secrets/public-key
GitHub Get Repository Public Key
getRepositoryDependabotSecretsPublicKey 5 params → 200
GET
/repos/{owner}/{repo}/dependabot/secrets/{secret_name}
GitHub Get Repository Secret
getRepositoryDependabotSecret 6 params → 200
PUT
/repos/{owner}/{repo}/dependabot/secrets/{secret_name}
GitHub Create or Update Repository Secret
createOrUpdateRepositoryDependabotSecret 6 params body → 201204
DELETE
/repos/{owner}/{repo}/dependabot/secrets/{secret_name}
GitHub Delete Repository Secret
deleteRepositoryDependabotSecret 6 params → 204
GET
/repos/{owner}/{repo}/hooks
GitHub List Repository Webhooks
listRepositoryWebhooks 7 params → 200404
POST
/repos/{owner}/{repo}/hooks
GitHub Create Repository Webhook
createRepositoryWebhook 5 params body → 201403404422
GET
/repos/{owner}/{repo}/hooks/{hook_id}
GitHub Get Repository Webhook
getRepositoryWebhook 6 params → 200404
PATCH
/repos/{owner}/{repo}/hooks/{hook_id}
GitHub Update Repository Webhook
updateRepositoryWebhook 6 params body → 200404422
DELETE
/repos/{owner}/{repo}/hooks/{hook_id}
GitHub Delete Repository Webhook
deleteRepositoryWebhook 6 params → 204404
GET
/repos/{owner}/{repo}/hooks/{hook_id}/config
GitHub Get Webhook Configuration for Repository
getWebhookConfigurationForRepository 6 params → 200
PATCH
/repos/{owner}/{repo}/hooks/{hook_id}/config
GitHub Update Webhook Configuration for Repository
updateWebhookConfigurationForRepository 6 params body → 200
GET
/repos/{owner}/{repo}/hooks/{hook_id}/deliveries
GitHub List Deliveries for Repository Webhook
listDeliveriesForRepositoryWebhook 9 params → 200400422
GET
/repos/{owner}/{repo}/hooks/{hook_id}/deliveries/{delivery_id}
GitHub Get Delivery for Repository Webhook
getDeliveryForRepositoryWebhook 7 params → 200400422
POST
/repos/{owner}/{repo}/hooks/{hook_id}/deliveries/{delivery_id}/attempts
GitHub Redeliver Delivery for Repository Webhook
redeliverDeliveryForRepositoryWebhook 7 params → 202400422
POST
/repos/{owner}/{repo}/hooks/{hook_id}/pings
GitHub Ping Repository Webhook
pingRepositoryWebhook 6 params → 204404
POST
/repos/{owner}/{repo}/hooks/{hook_id}/tests
GitHub Test the Push Repository Webhook
testThePushRepositoryWebhook 6 params → 204404
GET
/repos/{owner}/{repo}/pre-receive-hooks
GitHub List Pre-receive Hooks for Repository
listPrereceiveHooksForRepository 9 params → 200
GET
/repos/{owner}/{repo}/pre-receive-hooks/{pre_receive_hook_id}
GitHub Get Pre-receive Hook for Repository
getPrereceiveHookForRepository 6 params → 200
PATCH
/repos/{owner}/{repo}/pre-receive-hooks/{pre_receive_hook_id}
GitHub Update Pre-receive Hook Enforcement for Repository
updatePrereceiveHookEnforcementForRepository 6 params body → 200
DELETE
/repos/{owner}/{repo}/pre-receive-hooks/{pre_receive_hook_id}
GitHub Remove Pre-receive Hook Enforcement for Repository
removePrereceiveHookEnforcementForRepository 6 params → 200
GET
/repos/{owner}/{repo}/invitations
GitHub List Repository Invitations
listRepositoryInvitations 7 params → 200
PATCH
/repos/{owner}/{repo}/invitations/{invitation_id}
GitHub Update Repository Invitation
updateRepositoryInvitation 6 params body → 200
DELETE
/repos/{owner}/{repo}/invitations/{invitation_id}
GitHub Delete Repository Invitation
deleteRepositoryInvitation 6 params → 204
GET
/repos/{owner}/{repo}/issues
GitHub List Repository Issues
listRepositoryIssues 16 params → 200301404422
GET
/repos/{owner}/{repo}/issues/comments
GitHub List Issue Comments for Repository
listIssueCommentsForRepository 10 params → 200404422
GET
/repos/{owner}/{repo}/issues/events
GitHub List Issue Events for Repository
listIssueEventsForRepository 7 params → 200422
GET
/repos/{owner}/{repo}/pulls/comments
GitHub List Review Comments in Repository
listReviewCommentsInRepository 10 params → 200
GET
/repos/{owner}/{repo}/subscription
GitHub Get Repository Subscription
getRepositorySubscription 5 params → 200403404
PUT
/repos/{owner}/{repo}/subscription
GitHub Set Repository Subscription
setRepositorySubscription 5 params body → 200
DELETE
/repos/{owner}/{repo}/subscription
GitHub Delete Repository Subscription
deleteRepositorySubscription 5 params → 204
GET
/repos/{owner}/{repo}
GitHub Get Repository
getRepository 5 params → 200301403404
PATCH
/repos/{owner}/{repo}
GitHub Update Repository
updateRepository 5 params body → 200307403404422
DELETE
/repos/{owner}/{repo}
GitHub Delete Repository
deleteRepository 5 params → 204307403404
PATCH
/repos/{owner}/{repo}/check-suites/preferences
GitHub Update Repository Preferences for Check Suites
updateRepositoryPreferencesForCheckSuites 5 params body → 200
GET
/repos/{owner}/{repo}/comments
GitHub List Commit Comments for Repository
listCommitCommentsForRepository 7 params → 200
GET
/repos/{owner}/{repo}/contents/{path}
GitHub Get Repository Content
getRepositoryContent 7 params → 200302403404
GET
/repos/{owner}/{repo}/contributors
GitHub List Repository Contributors
listRepositoryContributors 8 params → 200204403404
GET
/repos/{owner}/{repo}/dependency-graph/sbom
GitHub Export Software Bill of Materials (sbom) for Repository.
exportSoftwareBillOfMaterialsSbomForRepository 5 params → 200403404
POST
/repos/{owner}/{repo}/dependency-graph/snapshots
GitHub Create Snapshot of Dependencies for Repository
createSnapshotOfDependenciesForRepository 5 params body → 201
POST
/repos/{owner}/{repo}/dispatches
GitHub Create Repository Dispatch Event
createRepositoryDispatchEvent 5 params body → 204422
GET
/repos/{owner}/{repo}/events
GitHub List Repository Events
listRepositoryEvents 7 params → 200
GET
/repos/{owner}/{repo}/labels
GitHub List Labels for Repository
listLabelsForRepository 7 params → 200404
GET
/repos/{owner}/{repo}/languages
GitHub List Repository Languages
listRepositoryLanguages 5 params → 200
PUT
/repos/{owner}/{repo}/lfs
GitHub Enable Git Lfs for Repository
enableGitLfsForRepository 5 params → 202403
DELETE
/repos/{owner}/{repo}/lfs
GitHub Disable Git Lfs for Repository
disableGitLfsForRepository 5 params → 204
GET
/repos/{owner}/{repo}/license
GitHub Get the License for Repository
getTheLicenseForRepository 5 params → 200404
POST
/repos/{owner}/{repo}/merge-upstream
GitHub Sync Fork Branch with the Upstream Repository
syncForkBranchWithTheUpstreamRepository 5 params body → 200409422
GET
/repos/{owner}/{repo}/notifications
GitHub List Repository Notifications for the Authenticated User
listRepositoryNotificationsForTheAuthenticatedUser 11 params → 200
PUT
/repos/{owner}/{repo}/notifications
GitHub Mark Repository Notifications as Read
markRepositoryNotificationsAsRead 5 params body → 202205
GET
/repos/{owner}/{repo}/readme
GitHub Get Repository Readme
getRepositoryReadme 6 params → 200404422
GET
/repos/{owner}/{repo}/readme/{dir}
GitHub Get Repository Readme for Directory
getRepositoryReadmeForDirectory 7 params → 200404422
GET
/repos/{owner}/{repo}/replicas/caches
GitHub List Repository Cache Replication Status
listRepositoryCacheReplicationStatus 7 params → 200403404
GET
/repos/{owner}/{repo}/secret-scanning/alerts
GitHub List Secret Scanning Alerts for Repository
listSecretScanningAlertsForRepository 14 params → 200404503
GET
/repos/{owner}/{repo}/tags
GitHub List Repository Tags
listRepositoryTags 7 params → 200
GET
/repos/{owner}/{repo}/tags/protection
GitHub List Tag Protection States for Repository
listTagProtectionStatesForRepository 5 params → 200403404
POST
/repos/{owner}/{repo}/tags/protection
GitHub Create Tag Protection State for Repository
createTagProtectionStateForRepository 5 params body → 201403404
DELETE
/repos/{owner}/{repo}/tags/protection/{tag_protection_id}
GitHub Delete Tag Protection State for Repository
deleteTagProtectionStateForRepository 6 params → 204403404
GET
/repos/{owner}/{repo}/tarball/{ref}
GitHub Download Repository Archive (tar)
downloadRepositoryArchiveTar 6 params → 302
GET
/repos/{owner}/{repo}/teams
GitHub List Repository Teams
listRepositoryTeams 7 params → 200404
GET
/repos/{owner}/{repo}/topics
GitHub Get All Repository Topics
getAllRepositoryTopics 7 params → 200404
PUT
/repos/{owner}/{repo}/topics
GitHub Replace All Repository Topics
replaceAllRepositoryTopics 5 params body → 200404422
POST
/repos/{owner}/{repo}/transfer
GitHub Transfer Repository
transferRepository 5 params body → 202
GET
/repos/{owner}/{repo}/vulnerability-alerts
GitHub Check if Vulnerability Alerts Are Enabled for Repository
checkIfVulnerabilityAlertsAreEnabledForRepository 5 params → 204404
POST
/repos/{template_owner}/{template_repo}/generate
GitHub Create Repository Using Template
createRepositoryUsingTemplate 5 params body → 201
GET
/repositories
GitHub List Public Repositories
listPublicRepositories 5 params → 200304422
GET
/search/repositories
GitHub Search Repositories
searchRepositories 8 params → 200304422503
GET
/teams/{team_id}/reposdeprecated
GitHub List Team Repositories (legacy)
listTeamRepositoriesLegacy 3 params → 200404
GET
/teams/{team_id}/repos/{owner}/{repo}deprecated
GitHub Check Team Permissions for Repository (legacy)
checkTeamPermissionsForRepositoryLegacy 3 params → 200204404
PUT
/teams/{team_id}/repos/{owner}/{repo}deprecated
GitHub Add or Update Team Repository Permissions (legacy)
addOrUpdateTeamRepositoryPermissionsLegacy 3 params body → 204403422
DELETE
/teams/{team_id}/repos/{owner}/{repo}deprecated
GitHub Remove Repository from Team (legacy)
removeRepositoryFromTeamLegacy 3 params → 204

Schemas 199

The contract defines 199 schemas that model the data the API accepts and returns. The most detailed are full-repository_2 (102 properties), full-repository (102 properties), nullable-repository (95 properties), nullable-repository_2 (95 properties). Each schema is shown below with its type and property counts.

installation
object
Installation
20 properties 17 required
simple-user
object
A GitHub user.
21 properties 18 required
repository
object
A repository on GitHub.
95 properties 73 required
basic-error
object
Basic Error
4 properties
nullable-simple-user
objectnull
A GitHub user.
21 properties 18 required
app-permissions
object
The permissions granted to the user access token.
45 properties
enterprise
object
An enterprise on GitHub.
10 properties 8 required
nullable-license-simple
objectnull
License Simple
6 properties 5 required
issue-comment
object
Comments provide a way for people to collaborate on an issue.
14 properties 9 required
nullable-integration
objectnull
GitHub apps are a new way to extend GitHub. They can be installed directly on organizations and user accounts and granted access to specific repositories. They…
17 properties 11 required
issue
object
Issues are a great way to keep track of tasks, enhancements, and bugs for your projects.
34 properties 21 required
actor
object
Actor
6 properties 5 required
reaction-rollup
object
10 properties 10 required
event
object
Event
8 properties 7 required
author-association
string
How the author is associated with the repository.
nullable-milestone
objectnull
A collection of related issues and pull requests.
16 properties 16 required
nullable-repository
objectnull
A repository on GitHub.
95 properties 73 required
organization-custom-repository-role-update-schema
object
4 properties
code-of-conduct
object
Code Of Conduct
5 properties 4 required
minimal-repository
object
Minimal Repository
87 properties 46 required
security-and-analysis
objectnull
3 properties
validation-error
object
Validation Error
3 properties 2 required
repository-fine-grained-permission
object
A fine-grained permission that protects repository resources.
2 properties 2 required
organization-custom-repository-role-create-schema
object
4 properties 3 required
code-of-conduct-simple
object
Code of Conduct Simple
4 properties 4 required
team-repository
object
A team's access to a repository.
89 properties 73 required
full-repository
object
Full Repository
102 properties 75 required
organization-custom-repository-role
object
Custom repository roles created by organization owners
8 properties 7 required
actions-cache-usage-by-repository
object
GitHub Actions Cache Usage by repository.
3 properties 3 required
validation-error-simple
object
Validation Error Simple
3 properties 2 required
project
object
Projects are a way to organize columns and cards of work.
15 properties 13 required
workflow-run
object
An invocation of a workflow
36 properties 26 required
actions-secret
object
Set secrets for GitHub Actions.
3 properties 3 required
allowed-actions
string
The permissions policy that controls the actions that are allowed to run.
selected-actions
object
2 properties 2 required
runner
object
self hosted runner
7 properties 6 required
runner-label
object
label for a self hosted runner
3 properties 1 required
actions-workflow-access-to-repository
object
1 property 1 required
pull-request-minimal
object
5 properties 5 required
authentication-token
object
Authentication Token
6 properties 2 required
actions-enabled
boolean
Whether GitHub Actions is enabled on the repository.
scim-error
object
Scim Error
6 properties
actions-can-approve-pull-request-reviews
boolean
Whether GitHub Actions can approve pull requests. Enabling this can be a security risk.
actions-cache-list
object
Repository actions caches
2 properties 2 required
empty-object
object
An object without any properties.
nullable-simple-commit
object
commit.
6 properties 6 required
nullable-license-simple_2
object
License Simple
6 properties 5 required
actions-set-default-workflow-permissions
object
2 properties
actions-public-key
object
The public key used for setting Actions Secrets.
6 properties 2 required
actions-get-default-workflow-permissions
object
2 properties 2 required
code-of-conduct_2
object
Code Of Conduct
5 properties 4 required
minimal-repository_2
object
Minimal Repository
87 properties 46 required
security-and-analysis_2
object
3 properties
actions-default-workflow-permissions
string
The default workflow permissions granted to the GITHUBTOKEN when running workflows.
referenced-workflow
object
workflow referenced/reused by the initial caller workflow
3 properties 2 required
workflow
object
GitHub Actions workflow
11 properties 10 required
actions-repository-permissions
object
3 properties 1 required
runner-application
object
Runner Application
6 properties 4 required
actions-cache-usage-policy-for-repository
object
GitHub Actions cache usage policy for repository.
1 property 1 required
oidc-custom-sub-repo
object
Actions OIDC subject customization for a repository
2 properties 1 required
simple-user_2
object
GitHub user.
21 properties 18 required
repository_2
object
repository on GitHub.
95 properties 73 required
selected-actions-url
string
The API URL to use to get or set the actions that are allowed to run, when allowedactions is set to selected.
actions-variable
object
4 properties 4 required
artifact
object
An artifact
11 properties 10 required
validation-error_2
object
Validation Error
3 properties 2 required
autolink
object
An autolink reference.
4 properties 4 required
code-scanning-ref
string
The Git reference, formatted as refs/pull/ /merge, refs/pull/ /head, refs/heads/ or simply .
code-scanning-analysis-analysis-key
string
Identifies the configuration under which the analysis was executed. For example, in GitHub Actions this includes the workflow filename and job name.
code-scanning-alert-state
string
State of a code scanning alert.
code-scanning-alert-items
object
15 properties 12 required
alert-created-at
string
The time that the alert was created in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
code-scanning-alert-instance
object
10 properties
code-scanning-analysis-environment
string
Identifies the variable values associated with the environment in which this analysis was performed.
code-scanning-alert-severity
string
Severity of a code scanning alert.
alert-updated-at
string
The time that the alert was last updated in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
alert-html-url
string
The GitHub URL of the alert resource.
code-scanning-analysis-tool-guid
string
The GUID of the tool used to generate the code scanning analysis, if provided in the uploaded SARIF data.
code-scanning-alert-rule-summary
object
6 properties
code-scanning-alert-state-query
string
State of a code scanning alert.
code-scanning-analysis-commit-sha
string
The SHA of the commit to which the analysis you are uploading relates.
code-scanning-analysis-category
string
Identifies the configuration under which the analysis was executed. Used to distinguish between multiple analyses for the same tool and commit, but performed o…
code-scanning-analysis-tool-name
string
The name of the tool used to generate the code scanning analysis.
alert-instances-url
string
The REST API URL for fetching the list of instances for an alert.
alert-number
integer
The security alert number.
code-scanning-analysis-created-at
string
The time that the analysis was created in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
alert-fixed-at
string
The time that the alert was no longer detected and was considered fixed in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
code-scanning-analysis-tool-version
string
The version of the tool used to generate the code scanning analysis.
code-scanning-analysis-deletion
object
Successful deletion of a code scanning analysis
2 properties 2 required
alert-dismissed-at
string
The time that the alert was dismissed in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
code-scanning-analysis-sarif-id
string
An identifier for the upload.
nullable-simple-user_2
object
GitHub user.
21 properties 18 required
code-scanning-analysis
object
15 properties 14 required
code-scanning-alert-location
object
Describe a region within a file for the alert.
5 properties
code-scanning-analysis-url
string
The REST API URL of the analysis resource.
code-scanning-analysis-tool
object
3 properties
code-scanning-alert-dismissed-comment
string
The dismissal comment associated with the dismissal of the alert.
code-scanning-alert-dismissed-reason
string
Required when the state is dismissed. The reason for dismissing or closing the alert.
alert-url
string
The REST API URL of the alert resource.
code-scanning-alert-classification
string
classification of the file. For example to identify it as generated.
code-scanning-alert-environment
string
Identifies the variable values associated with the environment in which the analysis that generated this alert instance was performed, such as the language tha…
collaborator
object
Collaborator
22 properties 18 required
nullable-collaborator
object
Collaborator
22 properties 18 required
repository-collaborator-permission
object
Repository Collaborator Permission
3 properties 3 required
validation-error_3
object
Validation Error
3 properties 2 required
dependabot-public-key
object
The public key used for setting Dependabot Secrets.
2 properties 2 required
dependabot-alert-package
object
Details for the vulnerable package.
2 properties 2 required
alert-auto-dismissed-at
string
The time that the alert was auto-dismissed in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
dependabot-secret
object
Set secrets for Dependabot.
3 properties 3 required
dependabot-alert-security-vulnerability
object
Details pertaining to one vulnerable version range for the advisory.
4 properties 4 required
dependabot-alert-security-advisory
object
Details for the GitHub Security Advisory.
13 properties 13 required
dependabot-alert
object
Dependabot alert.
15 properties 14 required
nullable-simple-user_3
object
GitHub user.
21 properties 18 required
repository-pre-receive-hook
object
4 properties
webhook-config-content-type
string
The media type used to serialize the payloads. Supported values include json and form. The default is form.
hook-response
object
3 properties 3 required
validation-error_4
object
Validation Error
3 properties 2 required
webhook-config-secret
string
If provided, the secret will be used as the key to generate the HMAC hex digest value for [delivery signature headers](https://docs.github.com/enterprise-serve…
hook
object
Webhooks for repositories.
13 properties 12 required
webhook-config-insecure-ssl
hook-delivery-item
object
Delivery made by a webhook, without request and response information.
12 properties 11 required
hook-delivery
object
Delivery made by a webhook.
15 properties 13 required
webhook-config-url
string
The URL to which the payloads will be delivered.
webhook-config
object
Configuration object of the webhook
4 properties
simple-user_3
object
GitHub user.
21 properties 18 required
code-of-conduct_3
object
Code Of Conduct
5 properties 4 required
minimal-repository_3
object
Minimal Repository
87 properties 46 required
security-and-analysis_3
object
3 properties
nullable-simple-user_4
object
GitHub user.
21 properties 18 required
repository-invitation
object
Repository invitations let you manage who you collaborate with.
10 properties 9 required
team
object
Groups of organization members that gives permissions on specified repositories.
13 properties 11 required
issue-event-rename
object
Issue Event Rename
2 properties 2 required
nullable-issue
object
Issues are a great way to keep track of tasks, enhancements, and bugs for your projects.
34 properties 21 required
simple-user_4
object
GitHub user.
21 properties 18 required
issue-event-milestone
object
Issue Event Milestone
1 property 1 required
nullable-integration_2
object
GitHub apps are a new way to extend GitHub. They can be installed directly on organizations and user accounts and granted access to specific repositories. They…
17 properties 11 required
repository_3
object
repository on GitHub.
95 properties 73 required
issue-event-label
object
Issue Event Label
2 properties 2 required
validation-error_5
object
Validation Error
3 properties 2 required
nullable-simple-user_5
object
GitHub user.
21 properties 18 required
issue_2
object
Issues are a great way to keep track of tasks, enhancements, and bugs for your projects.
34 properties 21 required
issue-event-project-card
object
Issue Event Project Card
6 properties 5 required
nullable-team-simple
object
Groups of organization members that gives permissions on specified repositories.
12 properties 10 required
issue-event
object
Issue Event
22 properties 8 required
issue-event-dismissed-review
object
4 properties 3 required
nullable-milestone_2
object
collection of related issues and pull requests.
16 properties 16 required
nullable-license-simple_3
object
License Simple
6 properties 5 required
nullable-simple-user_6
object
GitHub user.
21 properties 18 required
project_2
object
Projects are a way to organize columns and cards of work.
15 properties 13 required
simple-user_5
object
GitHub user.
21 properties 18 required
pull-request-review-comment
object
Pull Request Review Comments are comments on a portion of the Pull Request's diff.
29 properties 16 required
repository-subscription
object
Repository invitations let you manage who you collaborate with.
6 properties 6 required
thread
object
Thread
9 properties 9 required
language
object
Language
tag-protection
object
Tag protection
5 properties 1 required
metadata
object
User-defined metadata to store domain-specific information limited to 8 keys with scalar values.
content-file
object
Content File
14 properties 12 required
repo-search-result-item
object
Repo Search Result Item
89 properties 74 required
content-submodule
object
An object describing a submodule
11 properties 11 required
tag
object
Tag
5 properties 5 required
content-tree
object
Content Tree
11 properties 12 required
nullable-simple-user_7
object
GitHub user.
21 properties 18 required
secret-scanning-alert-resolution
string
Required when the state is resolved. The reason for resolving the alert.
snapshot
object
Create a new snapshot of a repository's dependencies.
8 properties 6 required
secret-scanning-alert-state
string
Sets the state of the secret scanning alert. You must provide resolution when you set the state to resolved.
validation-error_6
object
Validation Error
3 properties 2 required
dependency
object
5 properties
event_2
object
Event
8 properties 7 required
manifest
object
4 properties 1 required
nullable-license-simple_4
object
License Simple
6 properties 5 required
nullable-repository_2
object
repository on GitHub.
95 properties 73 required
content-directory
array
list of directory items
code-of-conduct_4
object
Code Of Conduct
5 properties 4 required
minimal-repository_4
object
Minimal Repository
87 properties 46 required
merged-upstream
object
Results of a successful merge upstream request
3 properties
security-and-analysis_4
object
3 properties
label
object
Color-coded labels help you categorize and filter your issues (just like labels in Gmail).
7 properties 7 required
nullable-alert-updated-at
string
The time that the alert was last updated in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.
search-result-text-matches
array
actor_2
object
Actor
6 properties 5 required
topic
object
topic aggregates entities that are related to a subject.
1 property 1 required
nullable-milestone_3
object
collection of related issues and pull requests.
16 properties 16 required
installation_2
object
Installation
20 properties 17 required
dependency-graph-spdx-sbom
object
schema for the SPDX JSON format returned by the Dependency Graph.
1 property 1 required
simple-user_6
object
GitHub user.
21 properties 18 required
repository_4
object
repository on GitHub.
95 properties 73 required
nullable-integration_3
object
GitHub apps are a new way to extend GitHub. They can be installed directly on organizations and user accounts and granted access to specific repositories. They…
17 properties 11 required
contributor
object
Contributor
21 properties 2 required
commit-comment
object
Commit Comment
14 properties 13 required
code-of-conduct-simple_2
object
Code of Conduct Simple
4 properties 4 required
license-content
object
License Content
13 properties 13 required
content-symlink
object
An object describing a symlink
11 properties 11 required
full-repository_2
object
Full Repository
102 properties 75 required
secret-scanning-alert
object
17 properties
check-suite-preference
object
Check suite configuration preferences for a repository.
2 properties 2 required
enterprise_2
object
An enterprise on GitHub.
10 properties 8 required
issue_3
object
Issues are a great way to keep track of tasks, enhancements, and bugs for your projects.
34 properties 21 required
team_2
object
Groups of organization members that gives permissions on specified repositories.
13 properties 11 required
nullable-team-simple_2
objectnull
Groups of organization members that gives permissions on specified repositories.
12 properties 10 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

github-repositories-api-openapi.yml Raw ↑

Other APIs GitHub publishes across the network.

GitHub Events API
GitHub Feeds API
GitHub Gists API
GitHub Issues API
GitHub Licenses API
GitHub Markdown API
GitHub Meta API
GitHub Notifications API
GitHub Octocat API
GitHub Projects API
GitHub Repos API
GitHub Search API
Where this information came from

This is an independent, third-party profile of GitHub Repositories API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.