diff --git a/content/rest/overview/api-previews.md b/content/rest/overview/api-previews.md index 30f8c88d3e..7329089d74 100644 --- a/content/rest/overview/api-previews.md +++ b/content/rest/overview/api-previews.md @@ -18,6 +18,8 @@ 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. @@ -25,6 +27,10 @@ Exercise greater control over [deployments](/rest/reference/repos#deployments) w **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. @@ -33,6 +39,10 @@ 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. @@ -40,6 +50,8 @@ Get a [list of events](/rest/reference/issues#timeline) for an issue or pull req **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 @@ -152,6 +164,8 @@ 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`. @@ -159,6 +173,10 @@ You can now update the `environment` of a [deployment status](/rest/reference/re **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. @@ -166,6 +184,8 @@ You can now configure whether organization members can create repositories and w **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. @@ -191,6 +211,8 @@ 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. @@ -198,6 +220,8 @@ You can use a new endpoint to [update a pull request branch](/rest/reference/pul **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. @@ -205,7 +229,8 @@ You can use a new endpoint to [Create a repository using a template](/rest/refer **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).