From e007425e4ba13c7eb5d6366c8493cb52320e33ef Mon Sep 17 00:00:00 2001
From: docs-bot <77750099+docs-bot@users.noreply.github.com>
Date: Wed, 15 Apr 2026 09:52:42 -0700
Subject: [PATCH] GraphQL schema update (#60792)

Co-authored-by: github-merge-queue <118344674+github-merge-queue@users.noreply.github.com>
---
 src/graphql/data/fpt/changelog.json       |  28 +++++
 src/graphql/data/fpt/schema.docs.graphql  |  83 +++++++++++++++
 src/graphql/data/fpt/schema.json          | 120 ++++++++++++++++++++++
 src/graphql/data/ghec/schema.docs.graphql |  83 +++++++++++++++
 src/graphql/data/ghec/schema.json         | 120 ++++++++++++++++++++++
 5 files changed, 434 insertions(+)

diff --git a/src/graphql/data/fpt/changelog.json b/src/graphql/data/fpt/changelog.json
index fb8cb40ab5df..d44f1dc8cbbf 100644
--- a/src/graphql/data/fpt/changelog.json
+++ b/src/graphql/data/fpt/changelog.json
@@ -1,4 +1,32 @@
 [
+  {
+    "schemaChanges": [
+      {
+        "title": "The GraphQL schema includes these changes:",
+        "changes": [
+          "<p>Type <code>ArchivePullRequestInput</code> was added</p>",
+          "<p>Input field <code>clientMutationId</code> of type <code>String</code> was added to input object type <code>ArchivePullRequestInput</code></p>",
+          "<p>Input field <code>pullRequestId</code> of type <code>ID!</code> was added to input object type <code>ArchivePullRequestInput</code></p>",
+          "<p>Type <code>ArchivePullRequestPayload</code> was added</p>",
+          "<p>Field <code>clientMutationId</code> was added to object type <code>ArchivePullRequestPayload</code></p>",
+          "<p>Field <code>pullRequest</code> was added to object type <code>ArchivePullRequestPayload</code></p>",
+          "<p>Type <code>UnarchivePullRequestInput</code> was added</p>",
+          "<p>Input field <code>clientMutationId</code> of type <code>String</code> was added to input object type <code>UnarchivePullRequestInput</code></p>",
+          "<p>Input field <code>pullRequestId</code> of type <code>ID!</code> was added to input object type <code>UnarchivePullRequestInput</code></p>",
+          "<p>Type <code>UnarchivePullRequestPayload</code> was added</p>",
+          "<p>Field <code>clientMutationId</code> was added to object type <code>UnarchivePullRequestPayload</code></p>",
+          "<p>Field <code>pullRequest</code> was added to object type <code>UnarchivePullRequestPayload</code></p>",
+          "<p>Field <code>archivePullRequest</code> was added to object type <code>Mutation</code></p>",
+          "<p>Argument <code>input: ArchivePullRequestInput!</code> added to field <code>Mutation.archivePullRequest</code></p>",
+          "<p>Field <code>unarchivePullRequest</code> was added to object type <code>Mutation</code></p>",
+          "<p>Argument <code>input: UnarchivePullRequestInput!</code> added to field <code>Mutation.unarchivePullRequest</code></p>"
+        ]
+      }
+    ],
+    "previewChanges": [],
+    "upcomingChanges": [],
+    "date": "2026-04-15"
+  },
   {
     "schemaChanges": [
       {
diff --git a/src/graphql/data/fpt/schema.docs.graphql b/src/graphql/data/fpt/schema.docs.graphql
index 61d4dc0ca699..9a460f9be87e 100644
--- a/src/graphql/data/fpt/schema.docs.graphql
+++ b/src/graphql/data/fpt/schema.docs.graphql
@@ -1698,6 +1698,36 @@ type ArchiveProjectV2ItemPayload {
   item: ProjectV2Item
 }
 
+"""
+Autogenerated input type of ArchivePullRequest
+"""
+input ArchivePullRequestInput {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The Node ID of the pull request to archive.
+  """
+  pullRequestId: ID! @possibleTypes(concreteTypes: ["PullRequest"])
+}
+
+"""
+Autogenerated return type of ArchivePullRequest.
+"""
+type ArchivePullRequestPayload {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The pull request that was archived.
+  """
+  pullRequest: PullRequest
+}
+
 """
 Autogenerated input type of ArchiveRepository
 """
@@ -25962,6 +25992,17 @@ type Mutation {
     input: ArchiveProjectV2ItemInput!
   ): ArchiveProjectV2ItemPayload
 
+  """
+  Archive a pull request. Closes, locks, and marks the pull request as archived.
+  Only repository admins can archive pull requests.
+  """
+  archivePullRequest(
+    """
+    Parameters for ArchivePullRequest
+    """
+    input: ArchivePullRequestInput!
+  ): ArchivePullRequestPayload
+
   """
   Marks a repository as archived.
   """
@@ -27562,6 +27603,18 @@ type Mutation {
     input: UnarchiveProjectV2ItemInput!
   ): UnarchiveProjectV2ItemPayload
 
+  """
+  Unarchive a pull request. Removes the archived flag from the pull request.
+  Does not automatically reopen or unlock the pull request. Only repository
+  admins can unarchive pull requests.
+  """
+  unarchivePullRequest(
+    """
+    Parameters for UnarchivePullRequest
+    """
+    input: UnarchivePullRequestInput!
+  ): UnarchivePullRequestPayload
+
   """
   Unarchives a repository.
   """
@@ -64859,6 +64912,36 @@ type UnarchiveProjectV2ItemPayload {
   item: ProjectV2Item
 }
 
+"""
+Autogenerated input type of UnarchivePullRequest
+"""
+input UnarchivePullRequestInput {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The Node ID of the pull request to unarchive.
+  """
+  pullRequestId: ID! @possibleTypes(concreteTypes: ["PullRequest"])
+}
+
+"""
+Autogenerated return type of UnarchivePullRequest.
+"""
+type UnarchivePullRequestPayload {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The pull request that was unarchived.
+  """
+  pullRequest: PullRequest
+}
+
 """
 Autogenerated input type of UnarchiveRepository
 """
diff --git a/src/graphql/data/fpt/schema.json b/src/graphql/data/fpt/schema.json
index e87ee8176571..f72e60d17a9d 100644
--- a/src/graphql/data/fpt/schema.json
+++ b/src/graphql/data/fpt/schema.json
@@ -2057,6 +2057,40 @@
         }
       ]
     },
+    {
+      "name": "archivePullRequest",
+      "kind": "mutations",
+      "id": "archivepullrequest",
+      "href": "/graphql/reference/mutations#archivepullrequest",
+      "description": "<p>Archive a pull request. Closes, locks, and marks the pull request as archived.\nOnly repository admins can archive pull requests.</p>",
+      "inputFields": [
+        {
+          "name": "input",
+          "type": "ArchivePullRequestInput!",
+          "id": "archivepullrequestinput",
+          "kind": "input-objects",
+          "href": "/graphql/reference/input-objects#archivepullrequestinput"
+        }
+      ],
+      "returnFields": [
+        {
+          "name": "clientMutationId",
+          "type": "String",
+          "id": "string",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#string",
+          "description": "<p>A unique identifier for the client performing the mutation.</p>"
+        },
+        {
+          "name": "pullRequest",
+          "type": "PullRequest",
+          "id": "pullrequest",
+          "kind": "objects",
+          "href": "/graphql/reference/objects#pullrequest",
+          "description": "<p>The pull request that was archived.</p>"
+        }
+      ]
+    },
     {
       "name": "archiveRepository",
       "kind": "mutations",
@@ -7511,6 +7545,40 @@
         }
       ]
     },
+    {
+      "name": "unarchivePullRequest",
+      "kind": "mutations",
+      "id": "unarchivepullrequest",
+      "href": "/graphql/reference/mutations#unarchivepullrequest",
+      "description": "<p>Unarchive a pull request. Removes the archived flag from the pull request.\nDoes not automatically reopen or unlock the pull request. Only repository\nadmins can unarchive pull requests.</p>",
+      "inputFields": [
+        {
+          "name": "input",
+          "type": "UnarchivePullRequestInput!",
+          "id": "unarchivepullrequestinput",
+          "kind": "input-objects",
+          "href": "/graphql/reference/input-objects#unarchivepullrequestinput"
+        }
+      ],
+      "returnFields": [
+        {
+          "name": "clientMutationId",
+          "type": "String",
+          "id": "string",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#string",
+          "description": "<p>A unique identifier for the client performing the mutation.</p>"
+        },
+        {
+          "name": "pullRequest",
+          "type": "PullRequest",
+          "id": "pullrequest",
+          "kind": "objects",
+          "href": "/graphql/reference/objects#pullrequest",
+          "description": "<p>The pull request that was unarchived.</p>"
+        }
+      ]
+    },
     {
       "name": "unarchiveRepository",
       "kind": "mutations",
@@ -100871,6 +100939,32 @@
         }
       ]
     },
+    {
+      "name": "ArchivePullRequestInput",
+      "kind": "inputObjects",
+      "id": "archivepullrequestinput",
+      "href": "/graphql/reference/input-objects#archivepullrequestinput",
+      "description": "<p>Autogenerated input type of ArchivePullRequest.</p>",
+      "inputFields": [
+        {
+          "name": "clientMutationId",
+          "description": "<p>A unique identifier for the client performing the mutation.</p>",
+          "type": "String",
+          "id": "string",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#string"
+        },
+        {
+          "name": "pullRequestId",
+          "description": "<p>The Node ID of the pull request to archive.</p>",
+          "type": "ID!",
+          "id": "id",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#id",
+          "isDeprecated": false
+        }
+      ]
+    },
     {
       "name": "ArchiveRepositoryInput",
       "kind": "inputObjects",
@@ -111169,6 +111263,32 @@
         }
       ]
     },
+    {
+      "name": "UnarchivePullRequestInput",
+      "kind": "inputObjects",
+      "id": "unarchivepullrequestinput",
+      "href": "/graphql/reference/input-objects#unarchivepullrequestinput",
+      "description": "<p>Autogenerated input type of UnarchivePullRequest.</p>",
+      "inputFields": [
+        {
+          "name": "clientMutationId",
+          "description": "<p>A unique identifier for the client performing the mutation.</p>",
+          "type": "String",
+          "id": "string",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#string"
+        },
+        {
+          "name": "pullRequestId",
+          "description": "<p>The Node ID of the pull request to unarchive.</p>",
+          "type": "ID!",
+          "id": "id",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#id",
+          "isDeprecated": false
+        }
+      ]
+    },
     {
       "name": "UnarchiveRepositoryInput",
       "kind": "inputObjects",
diff --git a/src/graphql/data/ghec/schema.docs.graphql b/src/graphql/data/ghec/schema.docs.graphql
index 61d4dc0ca699..9a460f9be87e 100644
--- a/src/graphql/data/ghec/schema.docs.graphql
+++ b/src/graphql/data/ghec/schema.docs.graphql
@@ -1698,6 +1698,36 @@ type ArchiveProjectV2ItemPayload {
   item: ProjectV2Item
 }
 
+"""
+Autogenerated input type of ArchivePullRequest
+"""
+input ArchivePullRequestInput {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The Node ID of the pull request to archive.
+  """
+  pullRequestId: ID! @possibleTypes(concreteTypes: ["PullRequest"])
+}
+
+"""
+Autogenerated return type of ArchivePullRequest.
+"""
+type ArchivePullRequestPayload {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The pull request that was archived.
+  """
+  pullRequest: PullRequest
+}
+
 """
 Autogenerated input type of ArchiveRepository
 """
@@ -25962,6 +25992,17 @@ type Mutation {
     input: ArchiveProjectV2ItemInput!
   ): ArchiveProjectV2ItemPayload
 
+  """
+  Archive a pull request. Closes, locks, and marks the pull request as archived.
+  Only repository admins can archive pull requests.
+  """
+  archivePullRequest(
+    """
+    Parameters for ArchivePullRequest
+    """
+    input: ArchivePullRequestInput!
+  ): ArchivePullRequestPayload
+
   """
   Marks a repository as archived.
   """
@@ -27562,6 +27603,18 @@ type Mutation {
     input: UnarchiveProjectV2ItemInput!
   ): UnarchiveProjectV2ItemPayload
 
+  """
+  Unarchive a pull request. Removes the archived flag from the pull request.
+  Does not automatically reopen or unlock the pull request. Only repository
+  admins can unarchive pull requests.
+  """
+  unarchivePullRequest(
+    """
+    Parameters for UnarchivePullRequest
+    """
+    input: UnarchivePullRequestInput!
+  ): UnarchivePullRequestPayload
+
   """
   Unarchives a repository.
   """
@@ -64859,6 +64912,36 @@ type UnarchiveProjectV2ItemPayload {
   item: ProjectV2Item
 }
 
+"""
+Autogenerated input type of UnarchivePullRequest
+"""
+input UnarchivePullRequestInput {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The Node ID of the pull request to unarchive.
+  """
+  pullRequestId: ID! @possibleTypes(concreteTypes: ["PullRequest"])
+}
+
+"""
+Autogenerated return type of UnarchivePullRequest.
+"""
+type UnarchivePullRequestPayload {
+  """
+  A unique identifier for the client performing the mutation.
+  """
+  clientMutationId: String
+
+  """
+  The pull request that was unarchived.
+  """
+  pullRequest: PullRequest
+}
+
 """
 Autogenerated input type of UnarchiveRepository
 """
diff --git a/src/graphql/data/ghec/schema.json b/src/graphql/data/ghec/schema.json
index e87ee8176571..f72e60d17a9d 100644
--- a/src/graphql/data/ghec/schema.json
+++ b/src/graphql/data/ghec/schema.json
@@ -2057,6 +2057,40 @@
         }
       ]
     },
+    {
+      "name": "archivePullRequest",
+      "kind": "mutations",
+      "id": "archivepullrequest",
+      "href": "/graphql/reference/mutations#archivepullrequest",
+      "description": "<p>Archive a pull request. Closes, locks, and marks the pull request as archived.\nOnly repository admins can archive pull requests.</p>",
+      "inputFields": [
+        {
+          "name": "input",
+          "type": "ArchivePullRequestInput!",
+          "id": "archivepullrequestinput",
+          "kind": "input-objects",
+          "href": "/graphql/reference/input-objects#archivepullrequestinput"
+        }
+      ],
+      "returnFields": [
+        {
+          "name": "clientMutationId",
+          "type": "String",
+          "id": "string",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#string",
+          "description": "<p>A unique identifier for the client performing the mutation.</p>"
+        },
+        {
+          "name": "pullRequest",
+          "type": "PullRequest",
+          "id": "pullrequest",
+          "kind": "objects",
+          "href": "/graphql/reference/objects#pullrequest",
+          "description": "<p>The pull request that was archived.</p>"
+        }
+      ]
+    },
     {
       "name": "archiveRepository",
       "kind": "mutations",
@@ -7511,6 +7545,40 @@
         }
       ]
     },
+    {
+      "name": "unarchivePullRequest",
+      "kind": "mutations",
+      "id": "unarchivepullrequest",
+      "href": "/graphql/reference/mutations#unarchivepullrequest",
+      "description": "<p>Unarchive a pull request. Removes the archived flag from the pull request.\nDoes not automatically reopen or unlock the pull request. Only repository\nadmins can unarchive pull requests.</p>",
+      "inputFields": [
+        {
+          "name": "input",
+          "type": "UnarchivePullRequestInput!",
+          "id": "unarchivepullrequestinput",
+          "kind": "input-objects",
+          "href": "/graphql/reference/input-objects#unarchivepullrequestinput"
+        }
+      ],
+      "returnFields": [
+        {
+          "name": "clientMutationId",
+          "type": "String",
+          "id": "string",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#string",
+          "description": "<p>A unique identifier for the client performing the mutation.</p>"
+        },
+        {
+          "name": "pullRequest",
+          "type": "PullRequest",
+          "id": "pullrequest",
+          "kind": "objects",
+          "href": "/graphql/reference/objects#pullrequest",
+          "description": "<p>The pull request that was unarchived.</p>"
+        }
+      ]
+    },
     {
       "name": "unarchiveRepository",
       "kind": "mutations",
@@ -100871,6 +100939,32 @@
         }
       ]
     },
+    {
+      "name": "ArchivePullRequestInput",
+      "kind": "inputObjects",
+      "id": "archivepullrequestinput",
+      "href": "/graphql/reference/input-objects#archivepullrequestinput",
+      "description": "<p>Autogenerated input type of ArchivePullRequest.</p>",
+      "inputFields": [
+        {
+          "name": "clientMutationId",
+          "description": "<p>A unique identifier for the client performing the mutation.</p>",
+          "type": "String",
+          "id": "string",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#string"
+        },
+        {
+          "name": "pullRequestId",
+          "description": "<p>The Node ID of the pull request to archive.</p>",
+          "type": "ID!",
+          "id": "id",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#id",
+          "isDeprecated": false
+        }
+      ]
+    },
     {
       "name": "ArchiveRepositoryInput",
       "kind": "inputObjects",
@@ -111169,6 +111263,32 @@
         }
       ]
     },
+    {
+      "name": "UnarchivePullRequestInput",
+      "kind": "inputObjects",
+      "id": "unarchivepullrequestinput",
+      "href": "/graphql/reference/input-objects#unarchivepullrequestinput",
+      "description": "<p>Autogenerated input type of UnarchivePullRequest.</p>",
+      "inputFields": [
+        {
+          "name": "clientMutationId",
+          "description": "<p>A unique identifier for the client performing the mutation.</p>",
+          "type": "String",
+          "id": "string",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#string"
+        },
+        {
+          "name": "pullRequestId",
+          "description": "<p>The Node ID of the pull request to unarchive.</p>",
+          "type": "ID!",
+          "id": "id",
+          "kind": "scalars",
+          "href": "/graphql/reference/scalars#id",
+          "isDeprecated": false
+        }
+      ]
+    },
     {
       "name": "UnarchiveRepositoryInput",
       "kind": "inputObjects",