Explore by product

GraphQL API
English

This version of GitHub Enterprise will be discontinued on This version of GitHub Enterprise was discontinued on 2020-08-20. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Article version: Enterprise Server 2.18
GitHub.com Enterprise Server 2.21 Enterprise Server 2.20 Enterprise Server 2.19 Enterprise Server 2.18

Schema previews

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

In this article

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.

Audit log preview

This preview adds support for reading Audit Log entries.

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

application/vnd.github.audit-log-preview+json

Previewed schema members:

  • AccountPlanChangeAuditEntry.actorLocation

  • BusinessAddOrganizationAuditEntry.actorLocation

  • IssueCommentUpdateAuditEntry.actorLocation

  • OauthApplicationDestroyAuditEntry.actorLocation

  • OauthApplicationResetSecretAuditEntry.actorLocation

  • OauthApplicationRevokeTokensAuditEntry.actorLocation

  • OauthApplicationTransferAuditEntry.actorLocation

  • OrgAcceptBusinessInvitationAuditEntry.actorLocation

  • Organization.auditLog

  • OrgAuditLogExportAuditEntry.actorLocation

  • OrgBillingSignupErrorAuditEntry.actorLocation

  • OrgCancelBusinessInvitationAuditEntry.actorLocation

  • OrgCancelInvitationAuditEntry.actorLocation

  • OrgConfigDisableContributorsOnlyAuditEntry.actorLocation

  • OrgConfigDisableSockpuppetDisallowedAuditEntry.actorLocation

  • OrgConfigEnableContributorsOnlyAuditEntry.actorLocation

  • OrgConfigEnableSockpuppetDisallowedAuditEntry.actorLocation

  • OrgCreateAuditEntry.actorLocation

  • OrgRenameAuditEntry.actorLocation

  • PrivateRepositoryForkingClearAuditEntry.actorLocation

  • ProjectCreateAuditEntry.actorLocation

  • RepoAddTopicAuditEntry.actorLocation

  • RepoArchivedAuditEntry.actorLocation

  • RepoChangeMergeSettingAuditEntry.actorLocation

  • RepoCreateAuditEntry.actorLocation

  • RepoDestroyAuditEntry.actorLocation

  • RepoDisableAuditEntry.actorLocation

  • RepoEnableAuditEntry.actorLocation

  • RepoPagesCnameAuditEntry.actorLocation

  • RepoPagesCreateAuditEntry.actorLocation

  • RepoPagesDestroyAuditEntry.actorLocation

  • RepoPagesHttpsRedirectDisabledAuditEntry.actorLocation

  • RepoPagesHttpsRedirectEnabledAuditEntry.actorLocation

  • RepoPagesSourceAuditEntry.actorLocation

  • RepoRemoveTopicAuditEntry.actorLocation

  • RepoRenameAuditEntry.actorLocation

  • RepositoryVisibilityChangeClearAuditEntry.actorLocation

  • RepoTransferAuditEntry.actorLocation

  • RepoTransferStartAuditEntry.actorLocation

  • RepoUnarchivedAuditEntry.actorLocation

  • RepoUpdateMemberAuditEntry.actorLocation

  • TeamChangePrivacyAuditEntry.actorLocation

  • TeamCreateAuditEntry.actorLocation

  • TeamDeleteAuditEntry.actorLocation

  • TeamDestroyAuditEntry.actorLocation

  • TeamRenameAuditEntry.actorLocation

  • TeamUpdatePermissionAuditEntry.actorLocation

  • TeamUpdateRepositoryPermissionAuditEntry.actorLocation

  • UserAddEmailAuditEntry.actorLocation

  • UserStatusUpdateAuditEntry.actorLocation

  • AuditEntryActor

  • OrganizationAuditEntry

  • OrgRestoreMemberAuditEntryMembership

  • AuditLogOrder

  • AuditEntry

  • EnterpriseAuditEntryData

  • OauthApplicationAuditEntryData

  • OrganizationAuditEntryData

  • RepositoryAuditEntryData

  • TeamAuditEntryData

  • ActorLocation

  • MembersCanDeleteReposClearAuditEntry

  • MembersCanDeleteReposDisableAuditEntry

  • MembersCanDeleteReposEnableAuditEntry

  • OauthApplicationCreateAuditEntry

  • OrgAddBillingManagerAuditEntry

  • OrgAddMemberAuditEntry

  • OrgBlockUserAuditEntry

  • OrgConfigDisableCollaboratorsOnlyAuditEntry

  • OrgConfigEnableCollaboratorsOnlyAuditEntry

  • OrgDisableOauthAppRestrictionsAuditEntry

  • OrgDisableSamlAuditEntry

  • OrgDisableTwoFactorRequirementAuditEntry

  • OrgEnableOauthAppRestrictionsAuditEntry

  • OrgEnableSamlAuditEntry

  • OrgEnableTwoFactorRequirementAuditEntry

  • OrgInviteMemberAuditEntry

  • OrgInviteToBusinessAuditEntry

  • OrgOauthAppAccessApprovedAuditEntry

  • OrgOauthAppAccessDeniedAuditEntry

  • OrgOauthAppAccessRequestedAuditEntry

  • OrgRemoveBillingManagerAuditEntry

  • OrgRemoveMemberAuditEntry

  • OrgRemoveOutsideCollaboratorAuditEntry

  • OrgRestoreMemberAuditEntry

  • OrgRestoreMemberMembershipOrganizationAuditEntryData

  • OrgRestoreMemberMembershipRepositoryAuditEntryData

  • OrgRestoreMemberMembershipTeamAuditEntryData

  • OrgUnblockUserAuditEntry

  • OrgUpdateDefaultRepositoryPermissionAuditEntry

  • OrgUpdateMemberAuditEntry

  • OrgUpdateMemberRepositoryCreationPermissionAuditEntry

  • OrgUpdateMemberRepositoryInvitationPermissionAuditEntry

  • PrivateRepositoryForkingDisableAuditEntry

  • PrivateRepositoryForkingEnableAuditEntry

  • RepoAccessAuditEntry

  • RepoAddMemberAuditEntry

  • RepoConfigDisableAnonymousGitAccessAuditEntry

  • RepoConfigDisableCollaboratorsOnlyAuditEntry

  • RepoConfigDisableContributorsOnlyAuditEntry

  • RepoConfigDisableSockpuppetDisallowedAuditEntry

  • RepoConfigEnableAnonymousGitAccessAuditEntry

  • RepoConfigEnableCollaboratorsOnlyAuditEntry

  • RepoConfigEnableContributorsOnlyAuditEntry

  • RepoConfigEnableSockpuppetDisallowedAuditEntry

  • RepoConfigLockAnonymousGitAccessAuditEntry

  • RepoConfigUnlockAnonymousGitAccessAuditEntry

  • RepoRemoveMemberAuditEntry

  • RepositoryVisibilityChangeDisableAuditEntry

  • RepositoryVisibilityChangeEnableAuditEntry

  • TeamAddMemberAuditEntry

  • TeamAddRepositoryAuditEntry

  • TeamChangeParentTeamAuditEntry

  • TeamRemoveMemberAuditEntry

  • TeamRemoveRepositoryAuditEntry

  • AuditLogOrderField

  • OauthApplicationCreateAuditEntryState

  • OauthApplicationRevokeTokensAuditEntryState

  • OrgAddMemberAuditEntryPermission

  • OrgRemoveBillingManagerAuditEntryReason

  • OrgRemoveMemberAuditEntryMembershipType

  • OrgRemoveMemberAuditEntryReason

  • OrgRemoveOutsideCollaboratorAuditEntryMembershipType

  • OrgRemoveOutsideCollaboratorAuditEntryReason

  • OrgUpdateDefaultRepositoryPermissionAuditEntryPermission

  • OrgUpdateMemberAuditEntryPermission

  • OrgUpdateMemberRepositoryCreationPermissionAuditEntryVisibility

  • RepoAccessAuditEntryVisibility

  • RepoAddMemberAuditEntryVisibility

  • RepoRemoveMemberAuditEntryVisibility

  • PreciseDateTime

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

Draft pull requests preview

This preview adds support for draft pull requests.

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

application/vnd.github.shadow-cat-preview+json

Previewed schema members:

  • Mutation.markPullRequestReadyForReview

  • CreatePullRequestInput.draft

  • PullRequest.isDraft

Checks preview

This preview adds support for reading checks created by GitHub Apps.

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

application/vnd.github.antiope-preview+json

Previewed schema members:

  • CheckAnnotationRange

  • CheckAnnotationPosition

  • CheckAnnotationSpan

  • CheckAnnotation

  • CheckAnnotationConnection.nodes

  • CheckAnnotationData

  • CheckAnnotationEdge.node

  • CheckAnnotationLevel

  • CheckConclusionState

  • CheckStatusState

  • CheckSuiteAutoTriggerPreference

  • CheckRun

  • CheckRunConnection.nodes

  • CheckRunEdge.node

  • CheckRunAction

  • CheckRunFilter

  • CheckRunOutput

  • CheckRunOutputImage

  • CheckRunType

  • CheckSuite

  • CheckSuiteConnection.nodes

  • CheckSuiteEdge.node

  • CheckSuiteFilter

  • Commit.checkSuites

  • Mutation.createCheckRun

  • Mutation.createCheckSuite

  • Mutation.rerequestCheckSuite

  • Mutation.updateCheckRun

  • Mutation.updateCheckSuitePreferences

  • Push

  • RequestableCheckStatusState

  • UpdateCheckSuitePayload.checkSuite

Team discussions preview

Adds support for reading and managing discussions within teams.

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

application/vnd.github.echo-preview+json

Previewed schema members:

  • Mutation.createTeamDiscussion

  • Mutation.createTeamDiscussionComment

  • Mutation.deleteTeamDiscussion

  • Mutation.deleteTeamDiscussionComment

  • Mutation.updateTeamDiscussion

  • Mutation.updateTeamDiscussionComment

  • Team.discussion

  • Team.discussions

  • Team.discussionsResourcePath

  • Team.discussionsUrl

  • TeamDiscussion

  • TeamDiscussionComment

  • TeamDiscussionCommentConnection

  • TeamDiscussionCommentEdge

  • TeamDiscussionCommentOrder

  • TeamDiscussionCommentOrderField

  • TeamDiscussionConnection

  • TeamDiscussionEdge

  • TeamDiscussionOrder

  • TeamDiscussionOrderField

Hovercards preview

This preview adds support for reading hovercard contextual data

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

application/vnd.github.hagar-preview+json

Previewed schema members:

  • Issue.hovercard

  • PullRequest.hovercard

  • User.hovercard

  • HovercardContext

  • GenericHovercardContext

  • Hovercard

  • OrganizationTeamsHovercardContext

  • OrganizationsHovercardContext

  • ReviewStatusHovercardContext

  • ViewerHovercardContext

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

Repository vulnerability alerts preview

This preview adds support for viewing vulnerability alerts 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.vixen-preview+json

Previewed schema members:

  • RepositoryVulnerabilityAlert

  • Repository.vulnerabilityAlerts

  • RepositoryVulnerabilityAlertConnection

  • RepositoryVulnerabilityAlertEdge

Temporary cloning token for private repositories preview

This preview adds support for accessing a temporary token field for cloning private repositories.

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

application/vnd.github.daredevil-preview+json

Previewed schema members:

  • Repository.tempCloneToken

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

Minimize comments preview

This preview adds support for minimizing comments on issues, pull requests, commits, and gists.

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

application/vnd.github.queen-beryl-preview+json

Previewed schema members:

  • Mutation.minimizeComment

  • Mutation.unminimizeComment

  • Minimizable

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

Pinned issues preview

This preview adds support for pinned issues.

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

application/vnd.github.elektra-preview+json

Previewed schema members:

  • Repository.pinnedIssues

  • PinnedIssue

  • PinnedIssueEdge

  • PinnedIssueConnection

  • Mutation.pinIssue

  • Mutation.unpinIssue

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

Ask a human

Can't find what you're looking for?

Contact us

Product

Platform

Support

Company