# 重大更改

了解最近和即将发生的 GitHub GraphQL API 重大变更。

## 关于重大变更

重大变更是指可能需要集成商采取行动的任何变更。 我们将这些变更分为两类：

* **重大更改：** 会破坏现有 GraphQL API 查询的更改。 例如，删除字段就是重大变更。
* 危险变更：虽然不会破坏现有查询，但可能会影响客户端运行时行为的变更。 添加枚举值就是一个危险变更示例。

我们将在更改 GraphQL 架构前至少三个月宣布即将发生的重大变更，以便给集成商预留进行必要调整的时间。 变更在季度第一天（1 月 1 日、4 月 1 日、7 月 1 日或 10 月 1 日）生效。 例如，如果我们在 1 月 15 日宣布变更，将在 7 月 1 日执行。

## Changes scheduled for 2025-10-01

- **Breaking** A change will be made to `SecurityAdvisory.cvss`.

  **Description:** cvss will be removed. New cvss_severities field will now contain both cvss_v3 and cvss_v4 properties.

  **Reason:** cvss will be removed.

## Changes scheduled for 2025-09-04

- **Breaking** A change will be made to `SearchType.ISSUE_ADVANCED`.

  **Description:** ISSUE_ADVANCED will 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:** viewerCanCreateProjects will 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:** projects will 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:** project will 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:** isPrivate will 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:** project will 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:** viewerCanCreateProjects will 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:** projects will 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:** project will 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:** projectColumnName will 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:** project will 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:** databaseId will 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:** projectCards will 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:** databaseId will be removed. Use fullDatabaseId instead.

  **Reason:** databaseId will be removed because it does not support 64-bit signed integer identifiers.

- **Breaking** A change will be made to `ProjectV2View.databaseId`.

  **Description:** databaseId will be removed. Use fullDatabaseId instead.

  **Reason:** databaseId will be removed because it does not support 64-bit signed integer identifiers.

- **Breaking** A change will be made to `ProjectV2StatusUpdate.databaseId`.

  **Description:** databaseId will be removed. Use fullDatabaseId instead.

  **Reason:** databaseId will be removed because it does not support 64-bit signed integer identifiers.

- **Breaking** A change will be made to `ProjectV2Item.databaseId`.

  **Description:** databaseId will be removed. Use fullDatabaseId instead.

  **Reason:** databaseId will be removed because it does not support 64-bit signed integer identifiers.

- **Breaking** A change will be made to `ProjectV2.databaseId`.

  **Description:** databaseId will be removed. Use fullDatabaseId instead.

  **Reason:** databaseId will be removed because it does not support 64-bit signed integer identifiers.

- **Breaking** A change will be made to `ProjectProgress.todoPercentage`.

  **Description:** todoPercentage will 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:** todoCount will 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:** inProgressPercentage will 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:** inProgressCount will 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:** enabled will 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:** donePercentage will 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:** doneCount will 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:** viewerCanCreateProjects will 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:** projectsUrl will 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:** projectsResourcePath will 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:** projects will 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:** project will 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:** id will 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:** url will 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:** updatedAt will 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:** resourcePath will 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:** purpose will 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:** project will 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:** name will 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:** id will 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:** databaseId will 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:** createdAt will 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:** cards will 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_ARCHIVED will 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:** ARCHIVED will 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:** url will 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:** updatedAt will 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:** state will 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:** resourcePath will 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:** project will 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:** note will 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:** isArchived will 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:** id will 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:** databaseId will 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:** creator will 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:** createdAt will 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:** content will 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:** column will 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:** url will 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:** updatedAt will 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:** state will 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:** resourcePath will 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:** progress will 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:** pendingCards will 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:** owner will 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:** number will 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:** name will 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:** id will 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:** databaseId will 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:** creator will 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:** createdAt will 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:** columns will 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:** bodyHtml will 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:** body will 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:** viewerCanCreateProjects will 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:** projects will 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:** project will 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:** announcementUserDismissible will be removed. Use the announcementBanner object instead.

  **Reason:** The individual announcementX fields do not follow our standard GraphQL patterns.

- **Breaking** A change will be made to `Organization.announcementExpiresAt`.

  **Description:** announcementExpiresAt will be removed. Use the announcementBanner object instead.

  **Reason:** The individual announcementX fields do not follow our standard GraphQL patterns.

- **Breaking** A change will be made to `Organization.announcementCreatedAt`.

  **Description:** announcementCreatedAt will be removed. Use the announcementBanner object instead.

  **Reason:** The individual announcementX fields do not follow our standard GraphQL patterns.

- **Breaking** A change will be made to `Organization.announcement`.

  **Description:** announcement will be removed. Use the announcementBanner object instead.

  **Reason:** The individual announcementX fields do not follow our standard GraphQL patterns.

- **Breaking** A change will be made to `Mutation.updateProjectColumn`.

  **Description:** updateProjectColumn will 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:** updateProjectCard will 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:** updateProject will 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:** unlinkRepositoryFromProject will 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:** moveProjectColumn will 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:** moveProjectCard will 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:** linkRepositoryToProject will 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:** importProject will 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:** deleteProjectColumn will 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:** deleteProjectCard will 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:** deleteProject will 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:** createProject will 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:** convertProjectCardNoteToIssue will 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:** cloneProject will 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:** addProjectColumn will 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:** addProjectCard will 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:** projectColumnName will 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:** projectCard will 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:** project will 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:** previousProjectColumnName will 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:** databaseId will 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:** isPrivate will 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:** projectCards will 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:** hasTwoFactorEnabled will be removed. Use two_factor_method_security instead.

  **Reason:** has_two_factor_enabled will be removed.

- **Breaking** A change will be made to `EnterpriseOwnerInfo.admins.hasTwoFactorEnabled`.

  **Description:** hasTwoFactorEnabled will be removed. Use two_factor_method_security instead.

  **Reason:** has_two_factor_enabled will be removed.

- **Breaking** A change will be made to `Enterprise.members.hasTwoFactorEnabled`.

  **Description:** hasTwoFactorEnabled will be removed. Use two_factor_method_security instead.

  **Reason:** has_two_factor_enabled will be removed.

- **Breaking** A change will be made to `Enterprise.announcementUserDismissible`.

  **Description:** announcementUserDismissible will be removed. Use the announcementBanner object instead.

  **Reason:** The individual announcementX fields do not follow our standard GraphQL patterns.

- **Breaking** A change will be made to `Enterprise.announcementExpiresAt`.

  **Description:** announcementExpiresAt will be removed. Use the announcementBanner object instead.

  **Reason:** The individual announcementX fields do not follow our standard GraphQL patterns.

- **Breaking** A change will be made to `Enterprise.announcementCreatedAt`.

  **Description:** announcementCreatedAt will be removed. Use the announcementBanner object instead.

  **Reason:** The individual announcementX fields do not follow our standard GraphQL patterns.

- **Breaking** A change will be made to `Enterprise.announcement`.

  **Description:** announcement will be removed. Use the announcementBanner object instead.

  **Reason:** The individual announcementX fields do not follow our standard GraphQL patterns.

- **Breaking** A change will be made to `CreateIssueTypeInput.isPrivate`.

  **Description:** isPrivate will 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:** projectCard will 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:** project will 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:** announcementUserDismissible will be removed. Use the announcementBanner object instead.

  **Reason:** The individual announcementX fields do not follow our standard GraphQL patterns.

- **Breaking** A change will be made to `AnnouncementBannerI.announcementExpiresAt`.

  **Description:** announcementExpiresAt will be removed. Use the announcementBanner object instead.

  **Reason:** The individual announcementX fields do not follow our standard GraphQL patterns.

- **Breaking** A change will be made to `AnnouncementBannerI.announcementCreatedAt`.

  **Description:** announcementCreatedAt will be removed. Use the announcementBanner object instead.

  **Reason:** The individual announcementX fields do not follow our standard GraphQL patterns.

- **Breaking** A change will be made to `AnnouncementBannerI.announcement`.

  **Description:** announcement will be removed. Use the announcementBanner object instead.

  **Reason:** The individual announcementX fields do not follow our standard GraphQL patterns.

- **Breaking** A change will be made to `AddedToProjectEvent.projectColumnName`.

  **Description:** projectColumnName will 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:** projectCard will 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:** project will 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:** databaseId will 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:** expiresAt will be removed. Do not rely on this field, it is currently set to a date far in the future if a device key is expirationless

  **Reason:** 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:** hasWorkflowDispatchTrigger will be removed. Use has_workflow_dispatch_trigger_for_branch(branch_ref) instead.

  **Reason:** has_workflow_dispatch_trigger is 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:** url will 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:** resourcePath will 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:** number will 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:** discussion will 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:** bodyVersion will 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:** authorAssociation will 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:** viewerCanPin will 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:** url will 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:** title will 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:** team will 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:** resourcePath will 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:** number will 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:** isPrivate will 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:** isPinned will 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:** commentsUrl will 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:** commentsResourcePath will 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:** comments will 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:** bodyVersion will 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:** authorAssociation will 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:** databaseId will be removed. Use fullDatabaseId instead.

  **Reason:** databaseId will be removed because it does not support 64-bit signed integer identifiers.

- **Breaking** A change will be made to `PullRequestReview.databaseId`.

  **Description:** databaseId will be removed. Use fullDatabaseId instead.

  **Reason:** databaseId will be removed because it does not support 64-bit signed integer identifiers.

- **Breaking** A change will be made to `PullRequest.databaseId`.

  **Description:** databaseId will be removed. Use fullDatabaseId instead.

  **Reason:** databaseId will be removed because it does not support 64-bit signed integer identifiers.

- **Breaking** A change will be made to `OrganizationInvitation.inviter`.

  **Description:** inviter will be removed. inviter will be replaced by inviterActor.

  **Reason:** inviter will be removed.

- **Breaking** A change will be made to `CreateTeamDiscussionPayload.teamDiscussion`.

  **Description:** teamDiscussion will 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:** title will 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:** teamId will 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:** private will 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:** body will 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:** teamDiscussionComment will 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:** discussionId will 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:** body will 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_SPECIFIC will be removed.

  **Reason:** Suggested topics are no longer supported

- **Breaking** A change will be made to `TopicSuggestionDeclineReason.TOO_GENERAL`.

  **Description:** TOO_GENERAL will be removed.

  **Reason:** Suggested topics are no longer supported

- **Breaking** A change will be made to `TopicSuggestionDeclineReason.PERSONAL_PREFERENCE`.

  **Description:** PERSONAL_PREFERENCE will be removed.

  **Reason:** Suggested topics are no longer supported

- **Breaking** A change will be made to `TopicSuggestionDeclineReason.NOT_RELEVANT`.

  **Description:** NOT_RELEVANT will 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:** position will be removed. Use the line and startLine fields instead, which are file line numbers instead of diff line numbers

  **Reason:** We are phasing out diff-relative positioning for PR comments

- **Breaking** A change will be made to `PullRequestReviewComment.originalPosition`.

  **Description:** originalPosition will be removed.

  **Reason:** We are phasing out diff-relative positioning for PR comments

- **Breaking** A change will be made to `AddPullRequestReviewInput.comments`.

  **Description:** comments will be removed. use the threads argument instead

  **Reason:** We are deprecating comment fields that use diff-relative positioning

- **Breaking** A change will be made to `AddPullRequestReviewCommentInput.pullRequestReviewId`.

  **Description:** pullRequestReviewId will be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply instead

  **Reason:** We are deprecating the addPullRequestReviewComment mutation

- **Breaking** A change will be made to `AddPullRequestReviewCommentInput.pullRequestId`.

  **Description:** pullRequestId will be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply instead

  **Reason:** We are deprecating the addPullRequestReviewComment mutation

- **Breaking** A change will be made to `AddPullRequestReviewCommentInput.position`.

  **Description:** position will be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply instead

  **Reason:** We are deprecating the addPullRequestReviewComment mutation

- **Breaking** A change will be made to `AddPullRequestReviewCommentInput.path`.

  **Description:** path will be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply instead

  **Reason:** We are deprecating the addPullRequestReviewComment mutation

- **Breaking** A change will be made to `AddPullRequestReviewCommentInput.inReplyTo`.

  **Description:** inReplyTo will be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply instead

  **Reason:** We are deprecating the addPullRequestReviewComment mutation

- **Breaking** A change will be made to `AddPullRequestReviewCommentInput.commitOID`.

  **Description:** commitOID will be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply instead

  **Reason:** We are deprecating the addPullRequestReviewComment mutation

- **Breaking** A change will be made to `AddPullRequestReviewCommentInput.body`.

  **Description:** body will be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply instead

  **Reason:** We are deprecating the addPullRequestReviewComment mutation

## Changes scheduled for 2023-07-01

- **Breaking** A change will be made to `ProjectV2ItemFieldGroup.field`.

  **Description:** field will be removed. Check out the ProjectV2ItemFieldGroup#groupByField API as an example for the more capable alternative.

  **Reason:** The ProjectV2ItemFieldGroup#field API is deprecated in favour of the more capable ProjectV2ItemFieldGroup#groupByField API.

- **Breaking** A change will be made to `Commit.pushedDate`.

  **Description:** pushedDate will be removed.

  **Reason:** pushedDate is no longer supported.

## Changes scheduled for 2023-04-01

- **Breaking** A change will be made to `Repository.squashPrTitleUsedAsDefault`.

  **Description:** squashPrTitleUsedAsDefault will be removed. Use Repository.squashMergeCommitTitle instead.

  **Reason:** squashPrTitleUsedAsDefault will be removed.

- **Breaking** A change will be made to `ProjectV2View.verticalGroupBy`.

  **Description:** verticalGroupBy will be removed. Check out the ProjectV2View#vertical_group_by_fields API as an example for the more capable alternative.

  **Reason:** The ProjectV2View#vertical_group_by API is deprecated in favour of the more capable ProjectV2View#vertical_group_by_fields API.

- **Breaking** A change will be made to `ProjectV2View.sortBy`.

  **Description:** sortBy will be removed. Check out the ProjectV2View#sort_by_fields API as an example for the more capable alternative.

  **Reason:** The ProjectV2View#sort_by API is deprecated in favour of the more capable ProjectV2View#sort_by_fields API.

- **Breaking** A change will be made to `ProjectV2View.groupBy`.

  **Description:** groupBy will be removed. Check out the ProjectV2View#group_by_fields API as an example for the more capable alternative.

  **Reason:** The ProjectV2View#order_by API is deprecated in favour of the more capable ProjectV2View#group_by_field API.

## Changes scheduled for 2023-02-10

- **Breaking** A change will be made to `PackageType.MAVEN`.

  **Description:** MAVEN will 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:** visibleFields will be removed. Check out the ProjectV2View#fields API as an example for the more capable alternative.

  **Reason:** The ProjectV2View#visibleFields API is deprecated in favour of the more capable ProjectV2View#fields API.

- **Breaking** A change will be made to `Commit.changedFiles`.

  **Description:** changedFiles will be removed. Use changedFilesIfAvailable instead.

  **Reason:** changedFiles will be removed.

## Changes scheduled for 2022-12-28

- **Breaking** A change will be made to `PackageType.RUBYGEMS`.

  **Description:** RUBYGEMS will 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:** NUGET will 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:** NPM will 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:** branch will be removed.

  **Reason:** PRs are removed from the merge queue for the base branch, the branch argument is now a no-op

- **Breaking** A change will be made to `DependencyGraphDependency.packageLabel`.

  **Description:** packageLabel will be removed. Use normalized packageName field instead.

  **Reason:** packageLabel will be removed.

## Changes scheduled for 2022-07-01

- **Breaking** A change will be made to `AddPullRequestToMergeQueueInput.branch`.

  **Description:** branch will be removed.

  **Reason:** PRs are added to the merge queue for the base branch, the branch argument is now a no-op

## Changes scheduled for 2021-10-01

- **Breaking** A change will be made to `ReactionGroup.users`.

  **Description:** users will be removed. Use the reactors field 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:** DOCKER will 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:** DRAFT will be removed. Use PullRequest.isDraft instead.

  **Reason:** DRAFT state will be removed from this enum and isDraft should be used instead

## Changes scheduled for 2020-10-01

- **Breaking** A change will be made to `PullRequest.timeline`.

  **Description:** timeline will be removed. Use PullRequest.timelineItems instead.

  **Reason:** timeline will be removed

- **Breaking** A change will be made to `Issue.timeline`.

  **Description:** timeline will be removed. Use Issue.timelineItems instead.

  **Reason:** timeline will be removed

## Changes scheduled for 2020-01-01

- **Breaking** A change will be made to `UnassignedEvent.user`.

  **Description:** user will be removed. Use the assignee field instead.

  **Reason:** Assignees can now be mannequins.

- **Breaking** A change will be made to `AssignedEvent.user`.

  **Description:** user will be removed. Use the assignee field instead.

  **Reason:** Assignees can now be mannequins.

## Changes scheduled for 2019-04-01

- **Breaking** A change will be made to `LegacyMigration.uploadUrlTemplate`.

  **Description:** uploadUrlTemplate will be removed. Use uploadUrl instead.

  **Reason:** uploadUrlTemplate is being removed because it is not a standard URL and adds an extra user step.