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