Available Endpoints
Note: To access the API with your GitHub App, you must provide a custom media type in the Accept Header for your requests.
application/vnd.github.machine-man-preview+json
Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact GitHub Support.
The following endpoints are available for use by GitHub Apps. Your app can make the following requests using GraphQL v4 or REST v3 endpoints. For more information, see "GitHub Apps."
You must use an installation access token to access these endpoints.
Check Runs
- Create a check run
- Get a single check run
- Update a check run
- List annotations for a check run
- List check runs in a check suite
- List check runs for a specific ref
Check Suites
- Create a check suite
- Get a single check suite
- Rerequest check suite
- Set preferences for check suites on a repository
- List check suites for a specific ref
Codes Of Conduct
Content References
Deployment Statuses
Deployments
Events
- List public events
- List public events for a network of repositories
- List public events for an organization
- List events performed by a user
- List public events performed by a user
- List events that a user has received
- List public events that a user has received
Feeds
Git Blobs
Git Commits
Git Refs
- Create a reference
- Get a single reference
- List matching references
- Update a reference
- Delete a reference
Git Tags
Git Trees
Gitignore Templates
Installations
Interaction Limits
- Get interaction restrictions for an organization
- Add or update interaction restrictions for an organization
- Remove interaction restrictions for an organization
- Get interaction restrictions for a repository
- Add or update interaction restrictions for a repository
- Remove interaction restrictions for a repository
Issue Assignees
Issue Comments
- List comments on an issue
- Create a comment
- List comments in a repository
- Get a single comment
- Edit a comment
- Delete a comment
Issue Events
Issue Timeline
Issues
- List assignees
- Check assignee
- List issues for a repository
- Create an issue
- Get a single issue
- Edit an issue
- Lock an issue
- Unlock an issue
Labels
- List labels on an issue
- Add labels to an issue
- Replace all labels for an issue
- Remove all labels from an issue
- Remove a label from an issue
- List all labels for this repository
- Create a label
- Get a single label
- Update a label
- Delete a label
- Get labels for every issue in a milestone
Licenses
Markdown
Meta
Milestones
- List milestones for a repository
- Create a milestone
- Get a single milestone
- Update a milestone
- Delete a milestone
Organization Hooks
Organization Invitations
- List pending organization invitations
- Create organization invitation
- List organization invitation teams
Organization Members
- Members list
- Check membership
- Remove a member
- Get organization membership
- Add or update organization membership
- Remove organization membership
- Public members list
- Check public membership
Organization Outside Collaborators
Organization Team Projects
Organization Team Repositories
- List team repos
- Check if a team manages a repository
- Add or update team repository
- Remove team repository
Organization Teams
- List teams
- Edit team
- Get team membership
- Add or update team membership
- Remove team membership
- List child teams
Organizations
SCIM
- Get a list of provisioned identities
- Provision and invite users
- Get provisioning details for a single user
- Replace a provisioned user's information
- Update a user attribute
- Remove a user from the organization
Project Collaborators
- List collaborators
- Add user as a collaborator
- Remove user as a collaborator
- Review a user's permission level
Projects
- List organization projects
- Create an organization project
- Get a project
- Update a project
- Delete a project
- Create a project card
- List project columns
- Create a project column
- Get a project column
- Update a project column
- Delete a project column
- List project cards
- Move a project column
- Get a project card
- Update a project card
- Delete a project card
- Move a project card
- List repository projects
- Create a repository project
Pull Comments
- List comments on a pull request
- Create a comment
- List comments in a repository
- Get a single comment
- Edit a comment
- Delete a comment
Pull Request Review Events
Pull Request Review Requests
Pull Request Reviews
Pulls
- List pull requests
- Create a pull request
- Get a single pull request
- Update a pull request
- List commits on a pull request
- List pull requests files
- Get if a pull request has been merged
- Merge a pull request (Merge Button)
Reactions
- Delete a reaction
- List reactions for a commit comment
- Create reaction for a commit comment
- List reactions for an issue
- Create reaction for an issue
- List reactions for an issue comment
- Create reaction for an issue comment
- List reactions for a pull request review comment
- Create reaction for a pull request review comment
- List reactions for a team discussion comment
- Create reaction for a team discussion comment
- List reactions for a team discussion
- Create reaction for a team discussion
Repositories
- List organization repositories
- Create
- Get
- Edit
- Delete a repository
- Compare two commits
- List contributors
- List forks
- Create a fork
- List languages
- List tags
- List teams
- Transfer a repository
- List all public repositories
- List user repositories
Repository Activity
Repository Branches
- List branches
- Get branch
- Get branch protection
- Update branch protection
- Remove branch protection
- Get admin enforcement of protected branch
- Add admin enforcement of protected branch
- Remove admin enforcement of protected branch
- Get pull request review enforcement of protected branch
- Update pull request review enforcement of protected branch
- Remove pull request review enforcement of protected branch
- Get required signatures of protected branch
- Add required signatures of protected branch
- Remove required signatures of protected branch
- Get required status checks of protected branch
- Update required status checks of protected branch
- Remove required status checks of protected branch
- List required status checks contexts of protected branch
- Add required status checks contexts of protected branch
- Replace required status checks contexts of protected branch
- Remove required status checks contexts of protected branch
- Get restrictions of protected branch
- Remove restrictions of protected branch
- List teams with access to protected branch
- Add team restrictions of protected branch
- Replace team restrictions of protected branch
- Remove team restrictions of protected branch
- List users with access to protected branch
- Add user restrictions of protected branch
- Replace user restrictions of protected branch
- Remove user restrictions of protected branch
- Perform a merge
Repository Collaborators
- List collaborators
- Check if a user is a collaborator
- Add user as a collaborator
- Remove user as a collaborator
- Review a user's permission level
Repository Commit Comments
- List commit comments for a repository
- Get a single commit comment
- Update a commit comment
- Delete a commit comment
- List comments for a single commit
- Create a commit comment
Repository Commits
Repository Community
Repository Contents
- Get archive link
- Get contents
- Create or update a file
- Delete a file
- Get the contents of a repository's license
- Get the readme
Repository Hooks
Repository Invitations
Repository Keys
Repository Pages
Repository Releases
- List releases for a repository
- Create a release
- Get a single release
- Edit a release
- Delete a release
- List assets for a release
- Get a single release asset
- Edit a release asset
- Delete a release asset
- Get the latest release
- Get a release by tag name
Repository Stats
- Get the number of additions and deletions per week
- Get the last year of commit activity data
- Get contributors list with additions, deletions, and commit counts
- Get the weekly commit count for the repository owner and everyone else
- Get the number of commits per hour in each day
Root
Search
- Search code
- Search commits
- Search issues and pull requests
- Search labels
- Search repositories
- Search topics
- Search users
Statuses
Team Discussions
- List discussions
- Create a discussion
- Get a single discussion
- Edit a discussion
- Delete a discussion
- List comments
- Create a comment
- Get a single comment
- Edit a comment
- Delete a comment