Skip to main content

You can preview upcoming features and changes to the GitHub GraphQL schema before they are added to the GitHub GraphQL API.

About schema previews

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 a schema 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.

Note: The GraphQL schema members under preview cannot be accessed via the Explorer at this time.

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

Update refs preview update multiple refs in a single operation 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

Access to a repository's dependency graph preview

This preview adds support for reading a dependency graph for a repository.

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

application/vnd.github.hawkgirl-preview+json

Previewed schema members:

  • DependencyGraphManifest
  • Repository.dependencyGraphManifests
  • DependencyGraphManifestEdge
  • DependencyGraphManifestConnection
  • DependencyGraphDependency
  • DependencyGraphDependencyEdge
  • DependencyGraphDependencyConnection