GraphQL schema update (#57071)

Co-authored-by: heiskr <[email protected]>

Author: docs-bot

src/graphql/data/fpt/changelog.json

@@ -1,4 +1,23 @@
 [
+  {
+    "schemaChanges": [
+      {
+        "title": "The GraphQL schema includes these changes:",
+        "changes": []
+      }
+    ],
+    "previewChanges": [],
+    "upcomingChanges": [
+      {
+        "title": "The following changes will be made to the schema:",
+        "changes": [
+          "<p>On member <code>NotificationThread.list</code>:<code>list</code> will be removed. Use the <code>optionalList</code> field instead. <strong>Effective 2026-01-01</strong>.</p>",
+          "<p>On member <code>NotificationThread.subject</code>:<code>subject</code> will be removed. Use the <code>optionalSubject</code> field instead. <strong>Effective 2026-01-01</strong>.</p>"
+        ]
+      }
+    ],
+    "date": "2025-08-11"
+  },
   {
     "schemaChanges": [
       {

src/graphql/data/fpt/graphql_upcoming_changes.public.yml

@@ -1526,6 +1526,18 @@ upcoming_changes:
     date: '2025-10-01T00:00:00+00:00'
     criticality: breaking
     owner: github/advisory-database
+  - location: NotificationThread.list
+    description: '`list` will be removed. Use the `optionalList` field instead.'
+    reason: Null values are possible for this field.
+    date: '2026-01-01T00:00:00+00:00'
+    criticality: breaking
+    owner: github/notifications
+  - location: NotificationThread.subject
+    description: '`subject` will be removed. Use the `optionalSubject` field instead.'
+    reason: Null values are possible for this field.
+    date: '2026-01-01T00:00:00+00:00'
+    criticality: breaking
+    owner: github/notifications
   - location: AuditEntry.action
     description: '`action` will be removed.'
     reason: The GraphQL audit-log is deprecated. Please use the REST API instead.

src/graphql/data/fpt/upcoming-changes.json

@@ -8873,6 +8873,24 @@
       "owner": "audit_logs"
     }
   ],
+  "2026-01-01": [
+    {
+      "location": "NotificationThread.subject",
+      "description": "<p><code>subject</code> will be removed. Use the <code>optionalSubject</code> field instead.</p>",
+      "reason": "<p>Null values are possible for this field.</p>",
+      "date": "2026-01-01",
+      "criticality": "breaking",
+      "owner": "github/notifications"
+    },
+    {
+      "location": "NotificationThread.list",
+      "description": "<p><code>list</code> will be removed. Use the <code>optionalList</code> field instead.</p>",
+      "reason": "<p>Null values are possible for this field.</p>",
+      "date": "2026-01-01",
+      "criticality": "breaking",
+      "owner": "github/notifications"
+    }
+  ],
   "2025-10-01": [
     {
       "location": "SecurityAdvisory.cvss",

src/graphql/data/ghec/graphql_upcoming_changes.public.yml

@@ -1526,6 +1526,18 @@ upcoming_changes:
     date: '2025-10-01T00:00:00+00:00'
     criticality: breaking
     owner: github/advisory-database
+  - location: NotificationThread.list
+    description: '`list` will be removed. Use the `optionalList` field instead.'
+    reason: Null values are possible for this field.
+    date: '2026-01-01T00:00:00+00:00'
+    criticality: breaking
+    owner: github/notifications
+  - location: NotificationThread.subject
+    description: '`subject` will be removed. Use the `optionalSubject` field instead.'
+    reason: Null values are possible for this field.
+    date: '2026-01-01T00:00:00+00:00'
+    criticality: breaking
+    owner: github/notifications
   - location: AuditEntry.action
     description: '`action` will be removed.'
     reason: The GraphQL audit-log is deprecated. Please use the REST API instead.

src/graphql/data/ghec/upcoming-changes.json

@@ -8873,6 +8873,24 @@
       "owner": "audit_logs"
     }
   ],
+  "2026-01-01": [
+    {
+      "location": "NotificationThread.subject",
+      "description": "<p><code>subject</code> will be removed. Use the <code>optionalSubject</code> field instead.</p>",
+      "reason": "<p>Null values are possible for this field.</p>",
+      "date": "2026-01-01",
+      "criticality": "breaking",
+      "owner": "github/notifications"
+    },
+    {
+      "location": "NotificationThread.list",
+      "description": "<p><code>list</code> will be removed. Use the <code>optionalList</code> field instead.</p>",
+      "reason": "<p>Null values are possible for this field.</p>",
+      "date": "2026-01-01",
+      "criticality": "breaking",
+      "owner": "github/notifications"
+    }
+  ],
   "2025-10-01": [
     {
       "location": "SecurityAdvisory.cvss",