Skip to main content

此版本的 GitHub Enterprise 将停止服务 2023-01-18. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

架构预览

您可以在即将推出的功能和 GitHub GraphQL 架构变更添加至 GitHub GraphQL API 之前预览它们。

关于架构预览

在预览期间,我们可以根据开发者的反馈更改某些功能。 如果我们确实进行了更改,我们将在开发者博客上公布这些更改,而不会事先通知。

若要访问架构预览,需要在请求的 Accept 标头中提供自定义媒体类型。 每个预览的功能文档可指定要提供的自定义媒体类型。

注意:目前无法通过 Explorer 访问处于预览状态的 GraphQL 架构成员。

Access to package version deletion preview

This preview adds support for the DeletePackageVersion mutation which enables deletion of private package versions.

To toggle this preview and access the following schema members, you must provide a custom media type in the `Accept` header:

application/vnd.github.package-deletes-preview+json

Previewed schema members:

  • Mutation.deletePackageVersion

Deployments preview

This preview adds support for deployments mutations and new deployments features.

To toggle this preview and access the following schema members, you must provide a custom media type in the `Accept` header:

application/vnd.github.flash-preview+json

Previewed schema members:

  • DeploymentStatus.environment
  • Mutation.createDeploymentStatus
  • Mutation.createDeployment

Merge info preview

This preview adds support for accessing fields that provide more detailed information about a pull request's merge state.

To toggle this preview and access the following schema members, you must provide a custom media type in the `Accept` header:

application/vnd.github.merge-info-preview+json

Previewed schema members:

  • PullRequest.canBeRebased
  • PullRequest.mergeStateStatus

Update refs preview

This preview adds support for updating multiple refs in a single operation.

To toggle this preview and access the following schema members, you must provide a custom media type in the `Accept` header:

application/vnd.github.update-refs-preview+json

Previewed schema members:

  • Mutation.updateRefs
  • GitRefname
  • RefUpdate

Project event details preview

This preview adds project, project card, and project column details to project-related issue events.

To toggle this preview and access the following schema members, you must provide a custom media type in the `Accept` header:

application/vnd.github.starfox-preview+json

Previewed schema members:

  • AddedToProjectEvent.project
  • AddedToProjectEvent.projectCard
  • AddedToProjectEvent.projectColumnName
  • ConvertedNoteToIssueEvent.project
  • ConvertedNoteToIssueEvent.projectCard
  • ConvertedNoteToIssueEvent.projectColumnName
  • MovedColumnsInProjectEvent.project
  • MovedColumnsInProjectEvent.projectCard
  • MovedColumnsInProjectEvent.projectColumnName
  • MovedColumnsInProjectEvent.previousProjectColumnName
  • RemovedFromProjectEvent.project
  • RemovedFromProjectEvent.projectColumnName

Create content attachments preview

This preview adds support for creating content attachments.

To toggle this preview and access the following schema members, you must provide a custom media type in the `Accept` header:

application/vnd.github.corsair-preview+json

Previewed schema members:

  • Mutation.createContentAttachment

Labels preview

This preview adds support for adding, updating, creating and deleting labels.

To toggle this preview and access the following schema members, you must provide a custom media type in the `Accept` header:

application/vnd.github.bane-preview+json

Previewed schema members:

  • Mutation.createLabel
  • Mutation.deleteLabel
  • Mutation.updateLabel

Import project preview

This preview adds support for importing projects.

To toggle this preview and access the following schema members, you must provide a custom media type in the `Accept` header:

application/vnd.github.slothette-preview+json

Previewed schema members:

  • Mutation.importProject

Team review assignments preview

This preview adds support for updating the settings for team review assignment.

To toggle this preview and access the following schema members, you must provide a custom media type in the `Accept` header:

application/vnd.github.stone-crop-preview+json

Previewed schema members:

  • Mutation.updateTeamReviewAssignment
  • TeamReviewAssignmentAlgorithm
  • Team.reviewRequestDelegationEnabled
  • Team.reviewRequestDelegationAlgorithm
  • Team.reviewRequestDelegationMemberCount
  • Team.reviewRequestDelegationNotifyTeam