About breaking changes
Breaking changes are any changes that might require action from our integrators. We divide these changes into two categories:
- Breaking: Changes that will break existing queries to the GraphQL API. For example, removing a field would be a breaking change.
- Dangerous: Changes that won't break existing queries but could affect the runtime behavior of clients. Adding an enum value is an example of a dangerous change.
We'll announce upcoming breaking changes at least three months before making changes to the GraphQL schema, to give integrators time to make the necessary adjustments. Changes go into effect on the first day of a quarter (January 1st, April 1st, July 1st, or October 1st). For example, if we announce a change on January 15th, it will be made on July 1st.
Changes scheduled for 2025-10-01
- Breaking A change will be made to
SecurityAdvisory.cvss.Description:cvsswill be removed. Newcvss_severitiesfield will now contain bothcvss_v3andcvss_v4properties.Reason:cvsswill be removed.
Changes scheduled for 2025-09-04
- Breaking A change will be made to
SearchType.ISSUE_ADVANCED.Description:ISSUE_ADVANCEDwill be removed.Reason:Search for issues and pull requests will be overridden by advanced search on September 4, 2025. You can read more about this change on https://github.blog/changelog/2025-03-06-github-issues-projects-api-support-for-issues-advanced-search-and-more/.
Changes scheduled for 2025-04-01
- Breaking A change will be made to
User.viewerCanCreateProjects.Description:viewerCanCreateProjectswill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
User.projects.Description:projectswill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
User.project.Description:projectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
UpdateIssueTypeInput.isPrivate.Description:isPrivatewill be removed.Reason:Private issue types are being deprecated and can no longer be created.
- Breaking A change will be made to
SearchShortcutQueryProjectTerm.project.Description:projectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Repository.viewerCanCreateProjects.Description:viewerCanCreateProjectswill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Repository.projects.Description:projectswill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Repository.project.Description:projectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
RemovedFromProjectEvent.projectColumnName.Description:projectColumnNamewill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
RemovedFromProjectEvent.project.Description:projectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
RemovedFromProjectEvent.databaseId.Description:databaseIdwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
PullRequest.projectCards.Description:projectCardswill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectV2Workflow.databaseId.Description:databaseIdwill be removed. UsefullDatabaseIdinstead.Reason:databaseIdwill be removed because it does not support 64-bit signed integer identifiers.
- Breaking A change will be made to
ProjectV2View.databaseId.Description:databaseIdwill be removed. UsefullDatabaseIdinstead.Reason:databaseIdwill be removed because it does not support 64-bit signed integer identifiers.
- Breaking A change will be made to
ProjectV2StatusUpdate.databaseId.Description:databaseIdwill be removed. UsefullDatabaseIdinstead.Reason:databaseIdwill be removed because it does not support 64-bit signed integer identifiers.
- Breaking A change will be made to
ProjectV2Item.databaseId.Description:databaseIdwill be removed. UsefullDatabaseIdinstead.Reason:databaseIdwill be removed because it does not support 64-bit signed integer identifiers.
- Breaking A change will be made to
ProjectV2.databaseId.Description:databaseIdwill be removed. UsefullDatabaseIdinstead.Reason:databaseIdwill be removed because it does not support 64-bit signed integer identifiers.
- Breaking A change will be made to
ProjectProgress.todoPercentage.Description:todoPercentagewill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectProgress.todoCount.Description:todoCountwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectProgress.inProgressPercentage.Description:inProgressPercentagewill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectProgress.inProgressCount.Description:inProgressCountwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectProgress.enabled.Description:enabledwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectProgress.donePercentage.Description:donePercentagewill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectProgress.doneCount.Description:doneCountwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectOwner.viewerCanCreateProjects.Description:viewerCanCreateProjectswill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectOwner.projectsUrl.Description:projectsUrlwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectOwner.projectsResourcePath.Description:projectsResourcePathwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectOwner.projects.Description:projectswill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectOwner.project.Description:projectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectOwner.id.Description:idwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectColumn.url.Description:urlwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectColumn.updatedAt.Description:updatedAtwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectColumn.resourcePath.Description:resourcePathwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectColumn.purpose.Description:purposewill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectColumn.project.Description:projectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectColumn.name.Description:namewill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectColumn.id.Description:idwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectColumn.databaseId.Description:databaseIdwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectColumn.createdAt.Description:createdAtwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectColumn.cards.Description:cardswill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectCardArchivedState.NOT_ARCHIVED.Description:NOT_ARCHIVEDwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectCardArchivedState.ARCHIVED.Description:ARCHIVEDwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectCard.url.Description:urlwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectCard.updatedAt.Description:updatedAtwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectCard.state.Description:statewill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectCard.resourcePath.Description:resourcePathwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectCard.project.Description:projectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectCard.note.Description:notewill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectCard.isArchived.Description:isArchivedwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectCard.id.Description:idwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectCard.databaseId.Description:databaseIdwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectCard.creator.Description:creatorwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectCard.createdAt.Description:createdAtwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectCard.content.Description:contentwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ProjectCard.column.Description:columnwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Project.url.Description:urlwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Project.updatedAt.Description:updatedAtwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Project.state.Description:statewill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Project.resourcePath.Description:resourcePathwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Project.progress.Description:progresswill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Project.pendingCards.Description:pendingCardswill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Project.owner.Description:ownerwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Project.number.Description:numberwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Project.name.Description:namewill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Project.id.Description:idwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Project.databaseId.Description:databaseIdwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Project.creator.Description:creatorwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Project.createdAt.Description:createdAtwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Project.columns.Description:columnswill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Project.bodyHTML.Description:bodyHtmlwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Project.body.Description:bodywill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Organization.viewerCanCreateProjects.Description:viewerCanCreateProjectswill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Organization.projects.Description:projectswill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Organization.project.Description:projectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Organization.announcementUserDismissible.Description:announcementUserDismissiblewill be removed. Use theannouncementBannerobject instead.Reason:The individual
announcementXfields do not follow our standard GraphQL patterns.
- Breaking A change will be made to
Organization.announcementExpiresAt.Description:announcementExpiresAtwill be removed. Use theannouncementBannerobject instead.Reason:The individual
announcementXfields do not follow our standard GraphQL patterns.
- Breaking A change will be made to
Organization.announcementCreatedAt.Description:announcementCreatedAtwill be removed. Use theannouncementBannerobject instead.Reason:The individual
announcementXfields do not follow our standard GraphQL patterns.
- Breaking A change will be made to
Organization.announcement.Description:announcementwill be removed. Use theannouncementBannerobject instead.Reason:The individual
announcementXfields do not follow our standard GraphQL patterns.
- Breaking A change will be made to
Mutation.updateProjectColumn.Description:updateProjectColumnwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Mutation.updateProjectCard.Description:updateProjectCardwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Mutation.updateProject.Description:updateProjectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Mutation.unlinkRepositoryFromProject.Description:unlinkRepositoryFromProjectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Mutation.moveProjectColumn.Description:moveProjectColumnwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Mutation.moveProjectCard.Description:moveProjectCardwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Mutation.linkRepositoryToProject.Description:linkRepositoryToProjectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Mutation.importProject.Description:importProjectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Mutation.deleteProjectColumn.Description:deleteProjectColumnwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Mutation.deleteProjectCard.Description:deleteProjectCardwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Mutation.deleteProject.Description:deleteProjectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Mutation.createProject.Description:createProjectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Mutation.convertProjectCardNoteToIssue.Description:convertProjectCardNoteToIssuewill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Mutation.cloneProject.Description:cloneProjectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Mutation.addProjectColumn.Description:addProjectColumnwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
Mutation.addProjectCard.Description:addProjectCardwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
MovedColumnsInProjectEvent.projectColumnName.Description:projectColumnNamewill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
MovedColumnsInProjectEvent.projectCard.Description:projectCardwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
MovedColumnsInProjectEvent.project.Description:projectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
MovedColumnsInProjectEvent.previousProjectColumnName.Description:previousProjectColumnNamewill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
MovedColumnsInProjectEvent.databaseId.Description:databaseIdwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
IssueType.isPrivate.Description:isPrivatewill be removed.Reason:Private issue types are being deprecated and can no longer be created.
- Breaking A change will be made to
Issue.projectCards.Description:projectCardswill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
EnterpriseOwnerInfo.outsideCollaborators.hasTwoFactorEnabled.Description:hasTwoFactorEnabledwill be removed. Usetwo_factor_method_securityinstead.Reason:has_two_factor_enabledwill be removed.
- Breaking A change will be made to
EnterpriseOwnerInfo.admins.hasTwoFactorEnabled.Description:hasTwoFactorEnabledwill be removed. Usetwo_factor_method_securityinstead.Reason:has_two_factor_enabledwill be removed.
- Breaking A change will be made to
Enterprise.members.hasTwoFactorEnabled.Description:hasTwoFactorEnabledwill be removed. Usetwo_factor_method_securityinstead.Reason:has_two_factor_enabledwill be removed.
- Breaking A change will be made to
Enterprise.announcementUserDismissible.Description:announcementUserDismissiblewill be removed. Use theannouncementBannerobject instead.Reason:The individual
announcementXfields do not follow our standard GraphQL patterns.
- Breaking A change will be made to
Enterprise.announcementExpiresAt.Description:announcementExpiresAtwill be removed. Use theannouncementBannerobject instead.Reason:The individual
announcementXfields do not follow our standard GraphQL patterns.
- Breaking A change will be made to
Enterprise.announcementCreatedAt.Description:announcementCreatedAtwill be removed. Use theannouncementBannerobject instead.Reason:The individual
announcementXfields do not follow our standard GraphQL patterns.
- Breaking A change will be made to
Enterprise.announcement.Description:announcementwill be removed. Use theannouncementBannerobject instead.Reason:The individual
announcementXfields do not follow our standard GraphQL patterns.
- Breaking A change will be made to
CreateIssueTypeInput.isPrivate.Description:isPrivatewill be removed.Reason:Private issue types are being deprecated and can no longer be created.
- Breaking A change will be made to
ConvertedNoteToIssueEvent.projectCard.Description:projectCardwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
ConvertedNoteToIssueEvent.project.Description:projectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
AnnouncementBannerI.announcementUserDismissible.Description:announcementUserDismissiblewill be removed. Use theannouncementBannerobject instead.Reason:The individual
announcementXfields do not follow our standard GraphQL patterns.
- Breaking A change will be made to
AnnouncementBannerI.announcementExpiresAt.Description:announcementExpiresAtwill be removed. Use theannouncementBannerobject instead.Reason:The individual
announcementXfields do not follow our standard GraphQL patterns.
- Breaking A change will be made to
AnnouncementBannerI.announcementCreatedAt.Description:announcementCreatedAtwill be removed. Use theannouncementBannerobject instead.Reason:The individual
announcementXfields do not follow our standard GraphQL patterns.
- Breaking A change will be made to
AnnouncementBannerI.announcement.Description:announcementwill be removed. Use theannouncementBannerobject instead.Reason:The individual
announcementXfields do not follow our standard GraphQL patterns.
- Breaking A change will be made to
AddedToProjectEvent.projectColumnName.Description:projectColumnNamewill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
AddedToProjectEvent.projectCard.Description:projectCardwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
AddedToProjectEvent.project.Description:projectwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
- Breaking A change will be made to
AddedToProjectEvent.databaseId.Description:databaseIdwill be removed.Reason:Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/.
Changes scheduled for 2025-01-01
- Breaking A change will be made to
AddMobileDevicePublicKeyPayload.expiresAt.Description:expiresAtwill be removed. Do not rely on this field, it is currently set to a date far in the future if a device key is expirationlessReason:We are deprecating expirations for mobile device keys used in mobile 2FA
Changes scheduled for 2024-10-01
- Breaking A change will be made to
Workflow.hasWorkflowDispatchTrigger.Description:hasWorkflowDispatchTriggerwill be removed. Usehas_workflow_dispatch_trigger_for_branch(branch_ref)instead.Reason:has_workflow_dispatch_triggeris being removed because it can be misleading and only checks a repository's default branch
Changes scheduled for 2024-07-01
- Breaking A change will be made to
TeamDiscussionComment.url.Description:urlwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussionComment.resourcePath.Description:resourcePathwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussionComment.number.Description:numberwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussionComment.discussion.Description:discussionwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussionComment.bodyVersion.Description:bodyVersionwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussionComment.authorAssociation.Description:authorAssociationwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussion.viewerCanPin.Description:viewerCanPinwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussion.url.Description:urlwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussion.title.Description:titlewill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussion.team.Description:teamwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussion.resourcePath.Description:resourcePathwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussion.number.Description:numberwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussion.isPrivate.Description:isPrivatewill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussion.isPinned.Description:isPinnedwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussion.commentsUrl.Description:commentsUrlwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussion.commentsResourcePath.Description:commentsResourcePathwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussion.comments.Description:commentswill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussion.bodyVersion.Description:bodyVersionwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
TeamDiscussion.authorAssociation.Description:authorAssociationwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
PullRequestReviewComment.databaseId.Description:databaseIdwill be removed. UsefullDatabaseIdinstead.Reason:databaseIdwill be removed because it does not support 64-bit signed integer identifiers.
- Breaking A change will be made to
PullRequestReview.databaseId.Description:databaseIdwill be removed. UsefullDatabaseIdinstead.Reason:databaseIdwill be removed because it does not support 64-bit signed integer identifiers.
- Breaking A change will be made to
PullRequest.databaseId.Description:databaseIdwill be removed. UsefullDatabaseIdinstead.Reason:databaseIdwill be removed because it does not support 64-bit signed integer identifiers.
- Breaking A change will be made to
OrganizationInvitation.inviter.Description:inviterwill be removed.inviterwill be replaced byinviterActor.Reason:inviterwill be removed.
- Breaking A change will be made to
CreateTeamDiscussionPayload.teamDiscussion.Description:teamDiscussionwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
CreateTeamDiscussionInput.title.Description:titlewill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
CreateTeamDiscussionInput.teamId.Description:teamIdwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
CreateTeamDiscussionInput.private.Description:privatewill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
CreateTeamDiscussionInput.body.Description:bodywill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
CreateTeamDiscussionCommentPayload.teamDiscussionComment.Description:teamDiscussionCommentwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
CreateTeamDiscussionCommentInput.discussionId.Description:discussionIdwill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
- Breaking A change will be made to
CreateTeamDiscussionCommentInput.body.Description:bodywill be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement.Reason:The Team Discussions feature is deprecated in favor of Organization Discussions.
Changes scheduled for 2024-04-01
- Breaking A change will be made to
TopicSuggestionDeclineReason.TOO_SPECIFIC.Description:TOO_SPECIFICwill be removed.Reason:Suggested topics are no longer supported
- Breaking A change will be made to
TopicSuggestionDeclineReason.TOO_GENERAL.Description:TOO_GENERALwill be removed.Reason:Suggested topics are no longer supported
- Breaking A change will be made to
TopicSuggestionDeclineReason.PERSONAL_PREFERENCE.Description:PERSONAL_PREFERENCEwill be removed.Reason:Suggested topics are no longer supported
- Breaking A change will be made to
TopicSuggestionDeclineReason.NOT_RELEVANT.Description:NOT_RELEVANTwill be removed.Reason:Suggested topics are no longer supported
Changes scheduled for 2023-10-01
- Breaking A change will be made to
PullRequestReviewComment.position.Description:positionwill be removed. Use thelineandstartLinefields instead, which are file line numbers instead of diff line numbersReason:We are phasing out diff-relative positioning for PR comments
- Breaking A change will be made to
PullRequestReviewComment.originalPosition.Description:originalPositionwill be removed.Reason:We are phasing out diff-relative positioning for PR comments
- Breaking A change will be made to
AddPullRequestReviewInput.comments.Description:commentswill be removed. use thethreadsargument insteadReason:We are deprecating comment fields that use diff-relative positioning
- Breaking A change will be made to
AddPullRequestReviewCommentInput.pullRequestReviewId.Description:pullRequestReviewIdwill be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply insteadReason:We are deprecating the addPullRequestReviewComment mutation
- Breaking A change will be made to
AddPullRequestReviewCommentInput.pullRequestId.Description:pullRequestIdwill be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply insteadReason:We are deprecating the addPullRequestReviewComment mutation
- Breaking A change will be made to
AddPullRequestReviewCommentInput.position.Description:positionwill be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply insteadReason:We are deprecating the addPullRequestReviewComment mutation
- Breaking A change will be made to
AddPullRequestReviewCommentInput.path.Description:pathwill be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply insteadReason:We are deprecating the addPullRequestReviewComment mutation
- Breaking A change will be made to
AddPullRequestReviewCommentInput.inReplyTo.Description:inReplyTowill be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply insteadReason:We are deprecating the addPullRequestReviewComment mutation
- Breaking A change will be made to
AddPullRequestReviewCommentInput.commitOID.Description:commitOIDwill be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply insteadReason:We are deprecating the addPullRequestReviewComment mutation
- Breaking A change will be made to
AddPullRequestReviewCommentInput.body.Description:bodywill be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply insteadReason:We are deprecating the addPullRequestReviewComment mutation
Changes scheduled for 2023-07-01
- Breaking A change will be made to
ProjectV2ItemFieldGroup.field.Description:fieldwill be removed. Check out theProjectV2ItemFieldGroup#groupByFieldAPI as an example for the more capable alternative.Reason:The
ProjectV2ItemFieldGroup#fieldAPI is deprecated in favour of the more capableProjectV2ItemFieldGroup#groupByFieldAPI.
- Breaking A change will be made to
Commit.pushedDate.Description:pushedDatewill be removed.Reason:pushedDateis no longer supported.
Changes scheduled for 2023-04-01
- Breaking A change will be made to
Repository.squashPrTitleUsedAsDefault.Description:squashPrTitleUsedAsDefaultwill be removed. UseRepository.squashMergeCommitTitleinstead.Reason:squashPrTitleUsedAsDefaultwill be removed.
- Breaking A change will be made to
ProjectV2View.verticalGroupBy.Description:verticalGroupBywill be removed. Check out theProjectV2View#vertical_group_by_fieldsAPI as an example for the more capable alternative.Reason:The
ProjectV2View#vertical_group_byAPI is deprecated in favour of the more capableProjectV2View#vertical_group_by_fieldsAPI.
- Breaking A change will be made to
ProjectV2View.sortBy.Description:sortBywill be removed. Check out theProjectV2View#sort_by_fieldsAPI as an example for the more capable alternative.Reason:The
ProjectV2View#sort_byAPI is deprecated in favour of the more capableProjectV2View#sort_by_fieldsAPI.
- Breaking A change will be made to
ProjectV2View.groupBy.Description:groupBywill be removed. Check out theProjectV2View#group_by_fieldsAPI as an example for the more capable alternative.Reason:The
ProjectV2View#order_byAPI is deprecated in favour of the more capableProjectV2View#group_by_fieldAPI.
Changes scheduled for 2023-02-10
- Breaking A change will be made to
PackageType.MAVEN.Description:MAVENwill be removed.Reason:MAVEN will be removed from this enum as this type will be migrated to only be used by the Packages REST API.
Changes scheduled for 2023-01-01
- Breaking A change will be made to
ProjectV2View.visibleFields.Description:visibleFieldswill be removed. Check out theProjectV2View#fieldsAPI as an example for the more capable alternative.Reason:The
ProjectV2View#visibleFieldsAPI is deprecated in favour of the more capableProjectV2View#fieldsAPI.
- Breaking A change will be made to
Commit.changedFiles.Description:changedFileswill be removed. UsechangedFilesIfAvailableinstead.Reason:changedFileswill be removed.
Changes scheduled for 2022-12-28
- Breaking A change will be made to
PackageType.RUBYGEMS.Description:RUBYGEMSwill be removed.Reason:RUBYGEMS will be removed from this enum as this type will be migrated to only be used by the Packages REST API.
Changes scheduled for 2022-11-21
- Breaking A change will be made to
PackageType.NUGET.Description:NUGETwill be removed.Reason:NUGET will be removed from this enum as this type will be migrated to only be used by the Packages REST API.
- Breaking A change will be made to
PackageType.NPM.Description:NPMwill be removed.Reason:NPM will be removed from this enum as this type will be migrated to only be used by the Packages REST API.
Changes scheduled for 2022-10-01
- Breaking A change will be made to
RemovePullRequestFromMergeQueueInput.branch.Description:branchwill be removed.Reason:PRs are removed from the merge queue for the base branch, the
branchargument is now a no-op
- Breaking A change will be made to
DependencyGraphDependency.packageLabel.Description:packageLabelwill be removed. Use normalizedpackageNamefield instead.Reason:packageLabelwill be removed.
Changes scheduled for 2022-07-01
- Breaking A change will be made to
AddPullRequestToMergeQueueInput.branch.Description:branchwill be removed.Reason:PRs are added to the merge queue for the base branch, the
branchargument is now a no-op
Changes scheduled for 2021-10-01
- Breaking A change will be made to
ReactionGroup.users.Description:userswill be removed. Use thereactorsfield instead.Reason:Reactors can now be mannequins, bots, and organizations.
Changes scheduled for 2021-06-21
- Breaking A change will be made to
PackageType.DOCKER.Description:DOCKERwill be removed.Reason:DOCKER will be removed from this enum as this type will be migrated to only be used by the Packages REST API.
Changes scheduled for 2021-01-01
- Breaking A change will be made to
MergeStateStatus.DRAFT.Description:DRAFTwill be removed. Use PullRequest.isDraft instead.Reason:DRAFT state will be removed from this enum and
isDraftshould be used instead
Changes scheduled for 2020-10-01
- Breaking A change will be made to
PullRequest.timeline.Description:timelinewill be removed. Use PullRequest.timelineItems instead.Reason:timelinewill be removed
- Breaking A change will be made to
Issue.timeline.Description:timelinewill be removed. Use Issue.timelineItems instead.Reason:timelinewill be removed
Changes scheduled for 2020-01-01
- Breaking A change will be made to
UnassignedEvent.user.Description:userwill be removed. Use theassigneefield instead.Reason:Assignees can now be mannequins.
- Breaking A change will be made to
AssignedEvent.user.Description:userwill be removed. Use theassigneefield instead.Reason:Assignees can now be mannequins.
Changes scheduled for 2019-04-01
- Breaking A change will be made to
LegacyMigration.uploadUrlTemplate.Description:uploadUrlTemplatewill be removed. UseuploadUrlinstead.Reason:uploadUrlTemplateis being removed because it is not a standard URL and adds an extra user step.