API Previews

API previews let you try out new APIs and changes to existing API methods before they become part of the official GitHub API.

During the preview period, we may change some features based on developer feedback. If we do make changes, we'll announce them on the developer blog without advance notice.

To access an API preview, you'll need to provide a custom media type in the Accept header for your requests. Feature documentation for each preview specifies which custom media type to provide.


Allows you to download repositories from your GitHub user or organization account to review, backup, and migrate data to GitHub Enterprise.

Custom media type: wyandotte-preview Announced: 2018-05-24

Source import

Import source repositories to GitHub with the API version of the GitHub Importer.

Custom media type: barred-rock-preview Announced: 2016-02-19 Update: 2016-05-03

Enhanced deployments

Exercise greater control over deployments with more information and finer granularity.

Custom media type: ant-man-preview Announced: 2016-04-06


Manage reactions for commits, issues, and comments.

Custom media type: squirrel-girl-preview Announced: 2016-05-12 Update: 2016-06-07


Get a list of events for an issue or pull request.

Custom media type: mockingbird-preview Announced: 2016-05-23


Get more information about your GitHub Pages site.

Custom media type: mister-fantastic-preview Announced: 2016-07-06


Manage integrations through the API.

Custom media type: machine-man-preview Announced: 2016-09-14


Manage projects.

Custom media type: inertia-preview Announced: 2016-09-14 Update: 2016-10-27

Commit search

Search commits.

Custom media type: cloak-preview Announced: 2017-01-05

Community profile metrics

Retrieve community profile metrics (also known as community health) for any public repository.

Custom media type: black-panther-preview Announced: 2017-02-09

User blocking

Users can block other users. Organizations can block users, too.

Custom media type: giant-sentry-fist-preview Announced: 2011-05-31 Update 1: 2016-04-04 Update 2: 2016-08-17


SCIM-enabled Identity Providers (IdPs) can automate provisioning of GitHub organization membership.

Custom media type: cloud-9-preview

Repository topics

View a list of repository topics in calls that return repository results.

Custom media type: mercy-preview Announced: 2017-01-31

Codes of conduct

View all codes of conduct or get which code of conduct a repository has currently.

Custom media type: scarlet-witch-preview

Nested teams

Include nested team content in team payloads.

Custom media type: hellcat-preview Announced: 2017-09-01

Repository transfer

Transfer a repository to an organization or user.

Custom media type: nightshade-preview Announced: 2017-11-09

Add lock reason

You can now add a reason when you lock an issue.

Custom media type: sailor-v-preview Announced: 2018-01-10

Organization invitations

You can now use the API to invite new users to an organization by creating an organization invitation.

Custom media type: dazzler-preview Announced: 2018-01-25

Team discussions

You can now use the API to manage team discussions and team discussion comments.

Custom media type: echo-preview Announced: 2018-02-07

Label emoji, search, and descriptions

You can now use emoji in label names, add descriptions to labels, and search for labels in a repository.

Custom media type: symmetra-preview Announced: 2018-02-22

Require signed commits

You can now use the API to manage the setting for requiring signed commits on protected branches.

Custom media type: zzzax-preview Announced: 2018-02-22

Require multiple approving reviews

You can now require multiple approving reviews for a pull request using the API.

Custom media type: luke-cage-preview Announced: 2018-03-16

Retrieve hovercard information

Retrieve information from someone's hovercard.

Custom media type: hagar-preview Announced: 2018-03-21

Check runs and check suites API

Allows a GitHub App to run external checks on a repository's code. See the Check runs and Check suites APIs for more details.

Custom media type: antiope-preview Announced: 2018-05-07

Project card details

The REST API v3 responses for issue events and issue timeline events now return the project_card field for project-related events.

Custom media type: starfox-preview Announced: 2018-09-05

GitHub App Manifests

GitHub App Manifests allow people to create preconfigured GitHub Apps. See "Creating GitHub Apps from a manifest" for more details.

Custom media type: fury-preview

Deployment statuses

You can now update the environment of a deployment status and use the in_progress and queued states. When you create deployment statuses, you can now use the auto_inactive parameter to mark old production deployments as inactive.

Custom media type: flash-preview Announced: 2018-10-16

Repository creation permissions

You can now configure whether organization members can create repositories and which types of repositories they can create. See "Edit an organization" for more details.

Custom media types: surtur-preview

Content attachments

You can now provide more information in GitHub for URLs that link to registered domains by using the Content Attachments API. See "Using content attachments" for more details.

Custom media types: corsair-preview Announced: 2018-12-10