GraphQL API Schema Changes
The GraphQL schema change log is a list of recent and upcoming changes to our GraphQL API schema. It includes backwards-compatible changes, schema previews, and upcoming breaking changes.
Breaking changes include changes that will break existing queries or could affect the runtime behavior of clients. For a list of breaking changes and when they will occur, see our breaking changes log.
GraphQL Schema Changes for 2020-09-23
The following changes will be made to the schema:
- On member
EnterprisePendingMemberInvitationEdge.isUnlicensed:isUnlicensedwill be removed. Effective 2020-07-01. - On member
EnterpriseMemberEdge.isUnlicensed:isUnlicensedwill be removed. Effective 2021-01-01. - On member
EnterpriseOutsideCollaboratorEdge.isUnlicensed:isUnlicensedwill be removed. Effective 2021-01-01. - On member
EnterprisePendingCollaboratorEdge.isUnlicensed:isUnlicensedwill be removed. Effective 2021-01-01. - On member
MergeStateStatus.DRAFT:DRAFTwill be removed. Use PullRequest.isDraft instead. Effective 2021-01-01.
The GraphQL schema includes these changes:
- Field
Blob.isBinarychanged type fromBoolean!toBoolean - Field
Ref.targetchanged type fromGitObject!toGitObject - Union member
BaseRefDeletedEventwas added to Union typePullRequestTimelineItem - Enum value
BASE_REF_DELETED_EVENTwas added to enumPullRequestTimelineItemsItemType - Union member
BaseRefDeletedEventwas added to Union typePullRequestTimelineItems - Enum value
PUBLIC_PRIVATEwas added to enumOrgUpdateMemberRepositoryCreationPermissionAuditEntryVisibility - Enum value
PUBLIC_INTERNALwas added to enumOrgUpdateMemberRepositoryCreationPermissionAuditEntryVisibility - Enum value
PRIVATE_INTERNALwas added to enumOrgUpdateMemberRepositoryCreationPermissionAuditEntryVisibility - Enum value
PRIVATEwas added to enumOrgUpdateMemberRepositoryCreationPermissionAuditEntryVisibility - Enum value
NONEwas added to enumOrgUpdateMemberRepositoryCreationPermissionAuditEntryVisibility - Enum value
INTERNALwas added to enumOrgUpdateMemberRepositoryCreationPermissionAuditEntryVisibility - Enum value
MANNEQUINwas added to enumCommentAuthorAssociation - Field
pathwas added to object typeTreeEntry - Field
isGeneratedwas added to object typeTreeEntry - Field
extensionwas added to object typeTreeEntry - Field
usedwas added to object typeRateLimit - Field
asCodeOwnerwas added to object typeReviewRequest - Field
viewerViewedStatewas added to object typePullRequestChangedFile - Field
unmarkFileAsViewedwas added to object typeMutation - Field
markFileAsViewedwas added to object typeMutation - Input field
authorEmailwas added to input object typeMergePullRequestInput - Input field
authorEmailwas added to input object typeMergeBranchInput - Field
isCrossRepositorywas added to object typeUnmarkedAsDuplicateEvent - Field
duplicatewas added to object typeUnmarkedAsDuplicateEvent - Field
canonicalwas added to object typeUnmarkedAsDuplicateEvent - Field
isCrossRepositorywas added to object typeMarkedAsDuplicateEvent - Field
duplicatewas added to object typeMarkedAsDuplicateEvent - Field
canonicalwas added to object typeMarkedAsDuplicateEvent - Field
groupswas added to object typeExternalIdentityScimAttributes - Field
givenNamewas added to object typeExternalIdentityScimAttributes - Field
familyNamewas added to object typeExternalIdentityScimAttributes - Field
emailswas added to object typeExternalIdentityScimAttributes - Field
usernamewas added to object typeExternalIdentitySamlAttributes - Field
groupswas added to object typeExternalIdentitySamlAttributes - Field
givenNamewas added to object typeExternalIdentitySamlAttributes - Field
familyNamewas added to object typeExternalIdentitySamlAttributes - Field
emailswas added to object typeExternalIdentitySamlAttributes - Field
isInOrganizationwas added to object typeRepositoryInfo - Field
permalinkwas added to object typeRepositoryInvitation - Input field
issueTemplatewas added to input object typeCreateIssueInput - Field
combinedContextswas added to object typeStatus - Field
deletedCommentAuthorwas added to object typeCommentDeletedEvent - Field
pullRequestwas added to object typeBaseRefChangedEvent - Field
previousRefNamewas added to object typeBaseRefChangedEvent - Field
currentRefNamewas added to object typeBaseRefChangedEvent - Field
stargazerCountwas added to object typeGist - Field
refUpdateRulewas added to object typeRef - Field
branchProtectionRulewas added to object typeRef - Argument
query: Stringadded to fieldRepository.milestones - Field
viewerPossibleCommitEmailswas added to object typeRepository - Field
viewerDefaultMergeMethodwas added to object typeRepository - Field
viewerDefaultCommitEmailwas added to object typeRepository - Field
securityPolicyUrlwas added to object typeRepository - Field
issueTemplateswas added to object typeRepository - Field
isUserConfigurationRepositorywas added to object typeRepository - Field
isSecurityPolicyEnabledwas added to object typeRepository - Field
isEmptywas added to object typeRepository - Field
isBlankIssuesEnabledwas added to object typeRepository - Field
contactLinkswas added to object typeRepository - Field
stargazerCountwas added to object typeRepository - Field
isInOrganizationwas added to object typeRepository - Field
viewerCanReplywas added to object typePullRequestReviewThread - Field
pathwas added to object typePullRequestReviewThread - Field
isOutdatedwas added to object typePullRequestReviewThread - Field
isCollapsedwas added to object typePullRequestReviewThread - Input field
AddPullRequestReviewThreadInput.pullRequestReviewIdchanged type fromID!toID - Input field
pullRequestIdwas added to input object typeAddPullRequestReviewThreadInput - Field
authorCanPushToRepositorywas added to object typePullRequestReview - Field
progressPercentagewas added to object typeMilestone - Enum value
MergeStateStatus.DRAFTwas deprecated with reasonDRAFT state will be removed from this enum andisDraftshould be used instead Use PullRequest.isDraft instead. Removal on 2021-01-01 UTC. - Field
viewerMergeHeadlineTextwas added to object typePullRequest - Field
viewerMergeBodyTextwas added to object typePullRequest - Field
viewerCanDeleteHeadRefwas added to object typePullRequest - Field
latestReviewswas added to object typePullRequest - Field
latestOpinionatedReviewswas added to object typePullRequest - Field
isReadByViewerwas added to object typePullRequest - Field
progresswas added to object typeProject - Field
filewas added to object typeCommit - Field
authorswas added to object typeCommit - Field
isReadByViewerwas added to object typeIssue - Field
bodyUrlwas added to object typeIssue - Field
bodyResourcePathwas added to object typeIssue - Field
stargazerCountwas added to object typeStarrable - Field
stargazerCountwas added to object typeTopic - Type
RepositoryContactLinkwas added - Type
RefUpdateRulewas added - Type
ProjectProgresswas added - Type
UnmarkFileAsViewedInputwas added - Type
UnmarkFileAsViewedPayloadwas added - Type
MarkFileAsViewedPayloadwas added - Type
MarkFileAsViewedInputwas added - Type
GitActorEdgewas added - Type
FileViewedStatewas added - Type
UserEmailMetadatawas added - Type
GitActorConnectionwas added - Type
BaseRefDeletedEventwas added - Type
IssueTemplatewas added
GraphQL Schema Changes for 2020-06-26
The GraphQL schema includes these changes:
- Type
TopicEdgewas removed - Type
RegistryPackageVersionEdgewas removed - Type
RegistryPackageVersionStatisticswas removed - Type
RegistryPackageTagEdgewas removed - Type
RegistryPackageFileEdgewas removed - Type
RegistryPackageDependencyEdgewas removed - Type
RegistryPackageMetadatumwas removed - Type
TopicConnectionwas removed - Type
RegistryPackageTagwas removed - Type
RegistryPackageTagConnectionwas removed - Type
RegistryPackageStatisticswas removed - Type
RegistryPackageVersionConnectionwas removed - Type
RegistryPackageTypewas removed - Type
RegistryPackagewas removed - Type
RegistryPackageFileConnectionwas removed - Type
RegistryPackageFilewas removed - Type
RegistryPackageDependencyTypewas removed - Type
RegistryPackageDependencywas removed - Type
RegistryPackageDependencyConnectionwas removed - Type
RegistryPackageVersionwas removed
GraphQL Schema Changes for 2020-06-23
The GraphQL schema includes these changes:
- Argument
packageType: PackageTypeadded to fieldOrganization.packages - Argument
packageType: PackageTypeadded to fieldUser.packages - Argument
packageType: PackageTypeadded to fieldPackageOwner.packages - Argument
packageType: PackageTypeadded to fieldRepository.packages
GraphQL Schema Changes for 2020-06-18
The GraphQL schema includes these changes:
- Field
databaseIdwas added to object typeTeam
GraphQL Schema Changes for 2020-06-05
The GraphQL schema includes these changes:
- Enum value
TWO_FACTOR_ACCOUNT_RECOVERYwas added to enumOrgRemoveMemberAuditEntryReason
GraphQL Schema Changes for 2020-06-01
The following changes will be made to the schema:
- On member
Blob.isBinary: Type forisBinarywill change fromBoolean!toBoolean. Effective 2019-07-01. - On member
Ref.target: Type fortargetwill change fromGitObject!toGitObject. Effective 2019-07-01.
The GraphQL schema includes these changes:
- Field
twitterUsernamewas added to object typeOrganization - Field
twitterUsernamewas added to object typeUser
GraphQL Schema Changes for 2020-05-23
The GraphQL schema includes these changes:
- Field
ipAllowListEntrieswas added to object typeOrganization - Field
ipAllowListEnabledSettingwas added to object typeOrganization
GraphQL Schema Changes for 2020-05-21
The following changes will be made to the schema:
- On member
RepositoryCollaboratorEdge.permission: Type forpermissionwill change fromRepositoryPermission!toString. Effective 2020-10-01. - On member
RepositoryInvitation.permission: Type forpermissionwill change fromRepositoryPermission!toString. Effective 2020-10-01. - On member
TeamRepositoryEdge.permission: Type forpermissionwill change fromRepositoryPermission!toString. Effective 2020-10-01.
The GraphQL schema includes these changes:
- Enum value
AUTOMATIC_BASE_CHANGE_SUCCEEDED_EVENTwas added to enumPullRequestTimelineItemsItemType - Enum value
AUTOMATIC_BASE_CHANGE_FAILED_EVENTwas added to enumPullRequestTimelineItemsItemType - Union member
AutomaticBaseChangeSucceededEventwas added to Union typePullRequestTimelineItems - Union member
AutomaticBaseChangeFailedEventwas added to Union typePullRequestTimelineItems - Type
AutomaticBaseChangeSucceededEventwas added - Type
AutomaticBaseChangeFailedEventwas added
GraphQL Schema Changes for 2020-05-19
The following changes will be made to the schema:
- On member
EnterpriseOwnerInfo.pendingCollaborators:pendingCollaboratorswill be removed. Use thependingCollaboratorInvitationsfield instead. Effective 2020-10-01. - On member
RepositoryInvitationOrderField.INVITEE_LOGIN:INVITEE_LOGINwill be removed. Effective 2020-10-01.
The GraphQL schema includes these changes:
- Field
RepositoryInvitation.inviteechanged type fromUser!toUser - Default value for argument
orderByon fieldEnterpriseOwnerInfo.pendingCollaboratorschanged from{"field"=>"INVITEE_LOGIN", "direction"=>"ASC"}to{"field"=>"CREATED_AT", "direction"=>"DESC"} - Enum value
RepositoryInvitationOrderField.INVITEE_LOGINwas deprecated with reason `INVITEE_LOGINis no longer a valid field value. Repository invitations can now be associated with an email, not only an invitee. Removal on 2020-10-01 UTC.` - Field
emailwas added to object typeRepositoryInvitation - Field
pendingCollaboratorInvitationswas added to object typeEnterpriseOwnerInfo - Type
RepositoryInvitationEdgewas added - Type
RepositoryInvitationConnectionwas added
GraphQL Schema Changes for 2020-05-13
The GraphQL schema includes these changes:
- Field
packageNamewas removed from object typeRepositoryVulnerabilityAlert - Field
fixedInwas removed from object typeRepositoryVulnerabilityAlert - Field
externalReferencewas removed from object typeRepositoryVulnerabilityAlert - Field
externalIdentifierwas removed from object typeRepositoryVulnerabilityAlert - Field
affectedRangewas removed from object typeRepositoryVulnerabilityAlert - Field
isDelistedwas removed from object typeMarketplaceListing - Field
isApprovedwas removed from object typeMarketplaceListing - Field
hasApprovalBeenRequestedwas removed from object typeMarketplaceListing - Field
pinnedRepositorieswas removed from object typeRepositoryOwner - Input field
fieldwas removed from input object typeContributionOrder - Field
pinnedRepositorieswas removed from object typeOrganization - Field
pinnedRepositorieswas removed from object typeUser - Type
ContributionOrderFieldwas removed - Default value for argument
orderByon fieldPullRequestReviewContributionsByRepository.contributionschanged from{"field"=>"OCCURRED_AT", "direction"=>"DESC"}to{"direction"=>"DESC"} - Default value for argument
orderByon fieldPullRequestContributionsByRepository.contributionschanged from{"field"=>"OCCURRED_AT", "direction"=>"DESC"}to{"direction"=>"DESC"} - Default value for argument
orderByon fieldIssueContributionsByRepository.contributionschanged from{"field"=>"OCCURRED_AT", "direction"=>"DESC"}to{"direction"=>"DESC"} - Default value for argument
orderByon fieldContributionsCollection.repositoryContributionschanged from{"field"=>"OCCURRED_AT", "direction"=>"DESC"}to{"direction"=>"DESC"} - Default value for argument
orderByon fieldContributionsCollection.pullRequestReviewContributionschanged from{"field"=>"OCCURRED_AT", "direction"=>"DESC"}to{"direction"=>"DESC"} - Default value for argument
orderByon fieldContributionsCollection.pullRequestContributionschanged from{"field"=>"OCCURRED_AT", "direction"=>"DESC"}to{"direction"=>"DESC"} - Default value for argument
orderByon fieldContributionsCollection.issueContributionschanged from{"field"=>"OCCURRED_AT", "direction"=>"DESC"}to{"direction"=>"DESC"}