API previews

You can use API previews to try out new features and provide feedback before these features become official.

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.

Search commits.

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

Repository topics

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

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

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

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

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

Create and use repository templates

You can use a new endpoint to Create a repository using a template and Create a repository for the authenticated user that is a template repository by setting the is_template parameter to true. Get a repository to check whether it's set as a template repository using the is_template key.

Custom media types: baptiste-preview Announced: 2019-07-05

Did this doc help you?Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.