Skip to content

Commit

Permalink
Graduate previews: flash, ant-man, squirrel-girl, mockingbird
Browse files Browse the repository at this point in the history
…, `lydian`, `surtur`, `nebula` (github#21835)

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
  • Loading branch information
skedwards88 and ethanpalm authored Oct 4, 2021
1 parent ee6441d commit 013ca6a
Showing 1 changed file with 26 additions and 1 deletion.
27 changes: 26 additions & 1 deletion content/rest/overview/api-previews.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,13 +18,19 @@ During the preview period, we may change some features based on developer feedba

To access an API preview, you'll need to provide a custom [media type](/rest/overview/media-types) in the `Accept` header for your requests. Feature documentation for each preview specifies which custom media type to provide.

{% ifversion ghes < 3.3 %}

## Enhanced deployments

Exercise greater control over [deployments](/rest/reference/repos#deployments) with more information and finer granularity.

**Custom media type:** `ant-man-preview`
**Announced:** [2016-04-06](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements/)

{% endif %}

{% ifversion ghes < 3.3 %}

## Reactions

Manage [reactions](/rest/reference/reactions) for commits, issues, and comments.
Expand All @@ -33,13 +39,19 @@ Manage [reactions](/rest/reference/reactions) for commits, issues, and comments.
**Announced:** [2016-05-12](https://developer.github.com/changes/2016-05-12-reactions-api-preview/)
**Update:** [2016-06-07](https://developer.github.com/changes/2016-06-07-reactions-api-update/)

{% endif %}

{% ifversion ghes < 3.3 %}

## Timeline

Get a [list of events](/rest/reference/issues#timeline) for an issue or pull request.

**Custom media type:** `mockingbird-preview`
**Announced:** [2016-05-23](https://developer.github.com/changes/2016-05-23-timeline-preview-api/)

{% endif %}

{% ifversion ghes %}
## Pre-receive environments

Expand Down Expand Up @@ -152,20 +164,28 @@ GitHub App Manifests allow people to create preconfigured GitHub Apps. See "[Cre

{% endif %}

{% ifversion ghes < 3.3 %}

## Deployment statuses

You can now update the `environment` of a [deployment status](/rest/reference/repos#create-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](https://developer.github.com/changes/2018-10-16-deployments-environments-states-and-auto-inactive-updates/)

{% endif %}

{% ifversion ghes < 3.3 %}

## Repository creation permissions

You can now configure whether organization members can create repositories and which types of repositories they can create. See "[Update an organization](/rest/reference/orgs#update-an-organization)" for more details.

**Custom media types:** `surtur-preview`
**Announced:** [2019-12-03](https://developer.github.com/changes/2019-12-03-internal-visibility-changes/)

{% endif %}

## Content attachments

You can now provide more information in GitHub for URLs that link to registered domains by using the {% data variables.product.prodname_unfurls %} API. See "[Using content attachments](/apps/using-content-attachments/)" for more details.
Expand All @@ -191,21 +211,26 @@ You can use two new endpoints in the [Commits API](/rest/reference/repos#commits

{% endif %}

{% ifversion ghes < 3.3 %}

## Update a pull request branch

You can use a new endpoint to [update a pull request branch](/rest/reference/pulls#update-a-pull-request-branch) with changes from the HEAD of the upstream branch.

**Custom media types:** `lydian-preview`
**Announced:** [2019-05-29](https://developer.github.com/changes/2019-05-29-update-branch-api/)

{% endif %}

## Create and use repository templates

You can use a new endpoint to [Create a repository using a template](/rest/reference/repos#create-a-repository-using-a-template) and [Create a repository for the authenticated user](/rest/reference/repos#create-a-repository-for-the-authenticated-user) that is a template repository by setting the `is_template` parameter to `true`. [Get a repository](/rest/reference/repos#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](https://developer.github.com/changes/2019-07-16-repository-templates-api/)

{% ifversion fpt or ghes or ghae %}
{% ifversion ghes < 3.3 %}

## New visibility parameter for the Repositories API

You can set and retrieve the visibility of a repository in the [Repositories API](/rest/reference/repos).
Expand Down

0 comments on commit 013ca6a

Please sign in to comment.