GraphQL schema update (#61613)

Co-authored-by: github-merge-queue <118344674+github-merge-queue@users.noreply.github.com>

Author: docs-bot

src/graphql/data/fpt/category-map.json

@@ -1245,6 +1245,7 @@
     "projectv2customfieldtype": "projects",
     "projectv2fieldorderfield": "projects",
     "projectv2fieldtype": "projects",
+    "projectv2itemarchivedstate": "projects",
     "projectv2itemfieldvalueorderfield": "projects",
     "projectv2itemorderfield": "projects",
     "projectv2itemtype": "projects",

src/graphql/data/fpt/changelog.json

@@ -1,4 +1,20 @@
 [
+  {
+    "schemaChanges": [
+      {
+        "title": "The GraphQL schema includes these changes:",
+        "changes": [
+          "<p>Type 'ProjectV2ItemArchivedState' was added</p>",
+          "<p>Enum value <code>ARCHIVED</code> was added to enum 'ProjectV2ItemArchivedState'</p>",
+          "<p>Enum value 'NOT_ARCHIVED<code>was added to enum</code>ProjectV2ItemArchivedState'</p>",
+          "<p>Argument 'archivedStates: [ProjectV2ItemArchivedState!]' (with default value) added to field 'ProjectV2.items'</p>"
+        ]
+      }
+    ],
+    "previewChanges": [],
+    "upcomingChanges": [],
+    "date": "2026-06-08"
+  },
   {
     "schemaChanges": [
       {

src/graphql/data/fpt/schema-projects.json

@@ -1372,6 +1372,15 @@
                 "href": "/graphql/reference/other#scalar-string"
               }
             },
+            {
+              "name": "archivedStates",
+              "description": "<p>Filter items by their archived state. Defaults to only returning items that are not archived.</p>",
+              "type": {
+                "name": "[ProjectV2ItemArchivedState!]",
+                "id": "projectv2itemarchivedstate",
+                "href": "/graphql/reference/projects#enum-projectv2itemarchivedstate"
+              }
+            },
             {
               "name": "before",
               "description": "<p>Returns the elements in the list that come before the specified cursor.</p>",
@@ -5119,6 +5128,24 @@
       ],
       "category": "projects"
     },
+    {
+      "name": "ProjectV2ItemArchivedState",
+      "id": "projectv2itemarchivedstate",
+      "href": "/graphql/reference/projects#enum-projectv2itemarchivedstate",
+      "description": "<p>The possible archived states of a <code>ProjectV2Item</code>.</p>",
+      "isDeprecated": false,
+      "values": [
+        {
+          "name": "ARCHIVED",
+          "description": "<p>A project item that is archived.</p>"
+        },
+        {
+          "name": "NOT_ARCHIVED",
+          "description": "<p>A project item that is not archived.</p>"
+        }
+      ],
+      "category": "projects"
+    },
     {
       "name": "ProjectV2ItemFieldValueOrderField",
       "id": "projectv2itemfieldvalueorderfield",

src/graphql/data/fpt/schema.docs.graphql

@@ -39602,6 +39602,11 @@ type ProjectV2 implements Closable & Node & Updatable @docsCategory(name: "proje
     """
     after: String
 
+    """
+    Filter items by their archived state. Defaults to only returning items that are not archived.
+    """
+    archivedStates: [ProjectV2ItemArchivedState!] = [NOT_ARCHIVED]
+
     """
     Returns the elements in the list that come before the specified cursor.
     """
@@ -40470,6 +40475,21 @@ type ProjectV2Item implements Node @docsCategory(name: "projects") {
   updatedAt: DateTime!
 }
 
+"""
+The possible archived states of a `ProjectV2Item`.
+"""
+enum ProjectV2ItemArchivedState @docsCategory(name: "projects") {
+  """
+  A project item that is archived
+  """
+  ARCHIVED
+
+  """
+  A project item that is not archived
+  """
+  NOT_ARCHIVED
+}
+
 """
 The connection type for ProjectV2Item.
 """

src/graphql/data/ghec/category-map.json

@@ -1245,6 +1245,7 @@
     "projectv2customfieldtype": "projects",
     "projectv2fieldorderfield": "projects",
     "projectv2fieldtype": "projects",
+    "projectv2itemarchivedstate": "projects",
     "projectv2itemfieldvalueorderfield": "projects",
     "projectv2itemorderfield": "projects",
     "projectv2itemtype": "projects",

src/graphql/data/ghec/schema-projects.json

@@ -1372,6 +1372,15 @@
                 "href": "/graphql/reference/other#scalar-string"
               }
             },
+            {
+              "name": "archivedStates",
+              "description": "<p>Filter items by their archived state. Defaults to only returning items that are not archived.</p>",
+              "type": {
+                "name": "[ProjectV2ItemArchivedState!]",
+                "id": "projectv2itemarchivedstate",
+                "href": "/graphql/reference/projects#enum-projectv2itemarchivedstate"
+              }
+            },
             {
               "name": "before",
               "description": "<p>Returns the elements in the list that come before the specified cursor.</p>",
@@ -5119,6 +5128,24 @@
       ],
       "category": "projects"
     },
+    {
+      "name": "ProjectV2ItemArchivedState",
+      "id": "projectv2itemarchivedstate",
+      "href": "/graphql/reference/projects#enum-projectv2itemarchivedstate",
+      "description": "<p>The possible archived states of a <code>ProjectV2Item</code>.</p>",
+      "isDeprecated": false,
+      "values": [
+        {
+          "name": "ARCHIVED",
+          "description": "<p>A project item that is archived.</p>"
+        },
+        {
+          "name": "NOT_ARCHIVED",
+          "description": "<p>A project item that is not archived.</p>"
+        }
+      ],
+      "category": "projects"
+    },
     {
       "name": "ProjectV2ItemFieldValueOrderField",
       "id": "projectv2itemfieldvalueorderfield",

src/graphql/data/ghec/schema.docs.graphql

@@ -39602,6 +39602,11 @@ type ProjectV2 implements Closable & Node & Updatable @docsCategory(name: "proje
     """
     after: String
 
+    """
+    Filter items by their archived state. Defaults to only returning items that are not archived.
+    """
+    archivedStates: [ProjectV2ItemArchivedState!] = [NOT_ARCHIVED]
+
     """
     Returns the elements in the list that come before the specified cursor.
     """
@@ -40470,6 +40475,21 @@ type ProjectV2Item implements Node @docsCategory(name: "projects") {
   updatedAt: DateTime!
 }
 
+"""
+The possible archived states of a `ProjectV2Item`.
+"""
+enum ProjectV2ItemArchivedState @docsCategory(name: "projects") {
+  """
+  A project item that is archived
+  """
+  ARCHIVED
+
+  """
+  A project item that is not archived
+  """
+  NOT_ARCHIVED
+}
+
 """
 The connection type for ProjectV2Item.
 """