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 2019-12-16
The GraphQL schema includes these changes:
- Field
actorwas added to object typeUpdatePullRequestPayload - Field
actorwas added to object typeUpdateIssuePayload - Field
actorwas added to object typeUnlockLockablePayload - Field
actorwas added to object typeMergePullRequestPayload - Field
actorwas added to object typeLockLockablePayload - Argument
orderBy: LabelOrderadded to fieldRepository.labels - Argument
orderBy: LabelOrderadded to fieldIssue.labels - Argument
orderBy: LabelOrderadded to fieldLabelable.labels - Argument
orderBy: LabelOrderadded to fieldPullRequest.labels - Type
LabelOrderFieldwas added - Type
LabelOrderwas added
GraphQL Schema Changes for 2019-12-11
The GraphQL schema includes these changes:
- Field
createdAtwas added to object typeRepositoryVulnerabilityAlert
GraphQL Schema Changes for 2019-12-05
The GraphQL schema includes these changes:
- Field
createdAtwas added to object typeSponsorsListing
GraphQL Schema Changes for 2019-11-25
The following changes will be made to the schema:
- On member
Organization.registryPackages:registryPackageswill be removed. Use thePackageOwnerobject instead. Effective 2020-04-01. - On member
Organization.registryPackagesForQuery:registryPackagesForQuerywill be removed. Use thePackageSearchobject instead. Effective 2020-04-01. - On member
RegistryPackage.color:colorwill be removed. Use thePackageobject instead. Effective 2020-04-01. - On member
RegistryPackage.latestVersion:latestVersionwill be removed. Use thePackageobject instead. Effective 2020-04-01. - On member
RegistryPackage.name:namewill be removed. Use thePackageobject instead. Effective 2020-04-01. - On member
RegistryPackage.nameWithOwner:nameWithOwnerwill be removed. Use thePackageobject instead. Effective 2020-04-01. - On member
RegistryPackage.packageFileByGuid:packageFileByGuidwill be removed. Use thePackageobject. Effective 2020-04-01. - On member
RegistryPackage.packageFileBySha256:packageFileBySha256will be removed. Use thePackageobject. Effective 2020-04-01. - On member
RegistryPackage.packageType:packageTypewill be removed. Use thePackageobject instead. Effective 2020-04-01. - On member
RegistryPackage.preReleaseVersions:preReleaseVersionswill be removed. Use thePackageobject instead. Effective 2020-04-01. - On member
RegistryPackage.registryPackageType:registryPackageTypewill be removed. Use thePackageobject instead. Effective 2020-04-01. - On member
RegistryPackage.repository:repositorywill be removed. Use thePackageobject instead. Effective 2020-04-01. - On member
RegistryPackage.statistics:statisticswill be removed. Use thePackageobject instead. Effective 2020-04-01. - On member
RegistryPackage.tags:tagswill be removed. Use thePackageobject. Effective 2020-04-01. - On member
RegistryPackage.topics:topicswill be removed. Use thePackageobject. Effective 2020-04-01. - On member
RegistryPackage.version:versionwill be removed. Use thePackageobject instead. Effective 2020-04-01. - On member
RegistryPackage.versionByPlatform:versionByPlatformwill be removed. Use thePackageobject instead. Effective 2020-04-01. - On member
RegistryPackage.versionBySha256:versionBySha256will be removed. Use thePackageobject instead. Effective 2020-04-01. - On member
RegistryPackage.versions:versionswill be removed. Use thePackageobject instead. Effective 2020-04-01. - On member
RegistryPackage.versionsByMetadatum:versionsByMetadatumwill be removed. Use thePackageobject instead. Effective 2020-04-01. - On member
RegistryPackageDependency.dependencyType:dependencyTypewill be removed. Use thePackageDependencyobject instead. Effective 2020-04-01. - On member
RegistryPackageDependency.name:namewill be removed. Use thePackageDependencyobject instead. Effective 2020-04-01. - On member
RegistryPackageDependency.version:versionwill be removed. Use thePackageDependencyobject instead. Effective 2020-04-01. - On member
RegistryPackageFile.guid:guidwill be removed. Use thePackageFileobject instead. Effective 2020-04-01. - On member
RegistryPackageFile.md5:md5will be removed. Use thePackageFileobject instead. Effective 2020-04-01. - On member
RegistryPackageFile.metadataUrl:metadataUrlwill be removed. Use thePackageFileobject instead. Effective 2020-04-01. - On member
RegistryPackageFile.name:namewill be removed. Use thePackageFileobject instead. Effective 2020-04-01. - On member
RegistryPackageFile.packageVersion:packageVersionwill be removed. Use thePackageFileobject instead. Effective 2020-04-01. - On member
RegistryPackageFile.sha1:sha1will be removed. Use thePackageFileobject instead. Effective 2020-04-01. - On member
RegistryPackageFile.sha256:sha256will be removed. Use thePackageFileobject instead. Effective 2020-04-01. - On member
RegistryPackageFile.size:sizewill be removed. Use thePackageFileobject instead. Effective 2020-04-01. - On member
RegistryPackageFile.url:urlwill be removed. Use thePackageFileobject instead. Effective 2020-04-01. - On member
RegistryPackageOwner.registryPackages:registryPackageswill be removed. Use thePackageOwnerobject instead. Effective 2020-04-01. - On member
RegistryPackageSearch.registryPackagesForQuery:registryPackagesForQuerywill be removed. Use thePackageSearchobject instead. Effective 2020-04-01. - On member
RegistryPackageStatistics.downloadsThisMonth:downloadsThisMonthwill be removed. Use thePackageStatisticsobject instead. Effective 2020-04-01. - On member
RegistryPackageStatistics.downloadsThisWeek:downloadsThisWeekwill be removed. Use thePackageStatisticsobject instead. Effective 2020-04-01. - On member
RegistryPackageStatistics.downloadsThisYear:downloadsThisYearwill be removed. Use thePackageStatisticsobject instead. Effective 2020-04-01. - On member
RegistryPackageStatistics.downloadsToday:downloadsTodaywill be removed. Use thePackageStatisticsobject instead. Effective 2020-04-01. - On member
RegistryPackageStatistics.downloadsTotalCount:downloadsTotalCountwill be removed. Use thePackageStatisticsobject instead. Effective 2020-04-01. - On member
RegistryPackageTag.name:namewill be removed. Use thePackageTagobject instead. Effective 2020-04-01. - On member
RegistryPackageTag.version:versionwill be removed. Use thePackageTagobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.deleted:deletedwill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.dependencies:dependencieswill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.fileByName:fileByNamewill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.files:fileswill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.installationCommand:installationCommandwill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.manifest:manifestwill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.platform:platformwill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.preRelease:preReleasewill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.readme:readmewill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.readmeHtml:readmeHtmlwill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.registryPackage:registryPackagewill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.release:releasewill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.sha256:sha256will be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.size:sizewill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.statistics:statisticswill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.summary:summarywill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.updatedAt:updatedAtwill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.version:versionwill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersion.viewerCanEdit:viewerCanEditwill be removed. Use thePackageVersionobject instead. Effective 2020-04-01. - On member
RegistryPackageVersionStatistics.downloadsThisMonth:downloadsThisMonthwill be removed. Use thePackageVersionStatisticsobject instead. Effective 2020-04-01. - On member
RegistryPackageVersionStatistics.downloadsThisWeek:downloadsThisWeekwill be removed. Use thePackageVersionStatisticsobject instead. Effective 2020-04-01. - On member
RegistryPackageVersionStatistics.downloadsThisYear:downloadsThisYearwill be removed. Use thePackageVersionStatisticsobject instead. Effective 2020-04-01. - On member
RegistryPackageVersionStatistics.downloadsToday:downloadsTodaywill be removed. Use thePackageVersionStatisticsobject instead. Effective 2020-04-01. - On member
RegistryPackageVersionStatistics.downloadsTotalCount:downloadsTotalCountwill be removed. Use thePackageVersionStatisticsobject instead. Effective 2020-04-01. - On member
Repository.registryPackages:registryPackageswill be removed. Use thePackageOwnerobject instead. Effective 2020-04-01. - On member
Repository.registryPackagesForQuery:registryPackagesForQuerywill be removed. Use thePackageSearchobject instead. Effective 2020-04-01. - On member
User.registryPackages:registryPackageswill be removed. Use thePackageOwnerobject instead. Effective 2020-04-01. - On member
User.registryPackagesForQuery:registryPackagesForQuerywill be removed. Use thePackageSearchobject instead. Effective 2020-04-01.
The GitHub Packages preview includes these changes:
- Field
statisticswas added to object typePackageVersion - Field
statisticswas added to object typePackage - Type
PackageStatisticswas added - Type
PackageVersionStatisticswas added
GraphQL Schema Changes for 2019-11-22
The GraphQL schema includes these changes:
- Field
unarchiveRepositorywas added to object typeMutation - Field
archiveRepositorywas added to object typeMutation - Field
fundingLinkswas added to object typeRepository - Type
UpdateTeamReviewAssignmentPayloadwas added - Type
UnarchiveRepositoryInputwas added - Type
UnarchiveRepositoryPayloadwas added - Type
ArchiveRepositoryInputwas added - Type
ArchiveRepositoryPayloadwas added - Type
FundingPlatformwas added - Type
FundingLinkwas added
The Team Review Assignments Preview preview includes these changes:
- Field
updateTeamReviewAssignmentwas added to object typeMutation - Field
reviewRequestDelegationNotifyTeamwas added to object typeTeam - Field
reviewRequestDelegationMemberCountwas added to object typeTeam - Field
reviewRequestDelegationEnabledwas added to object typeTeam - Field
reviewRequestDelegationAlgorithmwas added to object typeTeam - Type
UpdateTeamReviewAssignmentInputwas added - Type
TeamReviewAssignmentAlgorithmwas added
GraphQL Schema Changes for 2019-11-19
The GraphQL schema includes these changes:
- Field
hasProjectsEnabledwas added to object typeRepositoryInfo - Field
hasProjectsEnabledwas added to object typeRepository
GraphQL Schema Changes for 2019-11-06
The UpdateRefsPreview - Update multiple refs in a single operation. preview includes these changes:
- Field
updateRefswas added to object typeMutation - Type
GitRefnamewas added - Type
RefUpdatewas added - Type
UpdateRefsInputwas added - Type
UpdateRefsPayloadwas added
GraphQL Schema Changes for 2019-10-31
The following changes will be made to the schema:
- On member
Query.sponsorsListing:sponsorsListingwill be removed. UseSponsorable.sponsorsListinginstead. Effective 2020-04-01.
The GraphQL schema includes these changes:
- Input field
fieldwas added to input object typeSponsorshipOrder -
Repositoryobject implementsPackageOwnerinterface -
Userobject implementsPackageOwnerinterface -
Organizationobject implementsPackageOwnerinterface - Field
tierswas added to object typeSponsorsListing - Field
adminInfowas added to object typeSponsorsTier - Field
sponsorsListingwas added to object typeSponsorable - Field
sponsorsListingwas added to object typeUser - Field
sponsorsListingwas added to object typeOrganization - Type
SponsorsTierOrderFieldwas added - Type
SponsorsTierOrderwas added - Type
SponsorshipOrderFieldwas added - Type
SponsorsTierAdminInfowas added - Type
SponsorsTierConnectionwas added - Type
PackageVersionEdgewas added - Type
PackageVersionConnectionwas added - Type
PackageFileEdgewas added - Type
PackageFileConnectionwas added - Type
PackageEdgewas added - Type
PackageConnectionwas added
The GitHub Packages preview includes these changes:
- Field
packageswas added to object typeRepository - Field
packageswas added to object typeUser - Field
packageswas added to object typeOrganization - Type
PackageTagwas added - Type
PackageVersionOrderFieldwas added - Type
PackageVersionOrderwas added - Type
PackageOrderFieldwas added - Type
PackageOrderwas added - Type
PackageFileOrderFieldwas added - Type
PackageFileOrderwas added - Type
PackageFilewas added - Type
PackageVersionwas added - Type
Packagewas added - Type
PackageOwnerwas added
GraphQL Schema Changes for 2019-10-23
The GraphQL schema includes these changes:
- Field
tierwas added to object typeSponsorship - Type
SponsorsTierEdgewas added - Type
SponsorsTierwas added
GraphQL Schema Changes for 2019-10-09
The GraphQL schema includes these changes:
- Argument
query: Stringadded to fieldRepository.mentionableUsers