From 3dc44cce4be90933db9aae3c94e29e463e864d9c Mon Sep 17 00:00:00 2001
From: docs-bot <77750099+docs-bot@users.noreply.github.com>
Date: Mon, 24 Aug 2026 16:43:32 +0000
Subject: [PATCH] GraphQL schema update (#62894)

Co-authored-by: github-merge-queue <118344674+github-merge-queue@users.noreply.github.com>
---
 src/graphql/data/fpt/category-map.json    |  2 +
 src/graphql/data/fpt/changelog.json       | 22 ++++++++
 src/graphql/data/fpt/schema-issues.json   | 64 +++++++++++++++++++++++
 src/graphql/data/fpt/schema.docs.graphql  | 50 ++++++++++++++++++
 src/graphql/data/ghec/category-map.json   |  2 +
 src/graphql/data/ghec/schema-issues.json  | 64 +++++++++++++++++++++++
 src/graphql/data/ghec/schema.docs.graphql | 50 ++++++++++++++++++
 7 files changed, 254 insertions(+)

diff --git a/src/graphql/data/fpt/category-map.json b/src/graphql/data/fpt/category-map.json
index 4d426d9d6e8f..372140eb1444 100644
--- a/src/graphql/data/fpt/category-map.json
+++ b/src/graphql/data/fpt/category-map.json
@@ -1244,6 +1244,7 @@
     "issuefielddatatype": "issues",
     "issuefieldorderfield": "issues",
     "issuefieldsingleselectoptioncolor": "issues",
+    "issuefieldupdateoperation": "issues",
     "issuefieldvisibility": "issues",
     "issueorderfield": "issues",
     "issuesearchtype": "issues",
@@ -1595,6 +1596,7 @@
     "issuefieldcreateorupdateinput": "issues",
     "issuefieldorder": "issues",
     "issuefieldsingleselectoptioninput": "issues",
+    "issuefieldupdateinput": "issues",
     "issuefieldvaluefilter": "issues",
     "issuefilters": "issues",
     "issueorder": "issues",
diff --git a/src/graphql/data/fpt/changelog.json b/src/graphql/data/fpt/changelog.json
index a012e77740cf..0db5ef1f20af 100644
--- a/src/graphql/data/fpt/changelog.json
+++ b/src/graphql/data/fpt/changelog.json
@@ -1,4 +1,26 @@
 [
+  {
+    "schemaChanges": [
+      {
+        "title": "The GraphQL schema includes these changes:",
+        "changes": [
+          "<p>Type <code>IssueFieldUpdateInput</code> was added</p>",
+          "<p>Input field <code>fieldName</code> of type <code>String!</code> was added to input object type <code>IssueFieldUpdateInput</code></p>",
+          "<p>Input field <code>operation</code> of type <code>IssueFieldUpdateOperation!</code> was added to input object type <code>IssueFieldUpdateInput</code></p>",
+          "<p>Input field <code>value</code> of type <code>String</code> was added to input object type <code>IssueFieldUpdateInput</code></p>",
+          "<p>Type <code>IssueFieldUpdateOperation</code> was added</p>",
+          "<p>Enum value <code>ADD</code> was added to enum <code>IssueFieldUpdateOperation</code></p>",
+          "<p>Enum value <code>CLEAR</code> was added to enum <code>IssueFieldUpdateOperation</code></p>",
+          "<p>Enum value <code>REMOVE</code> was added to enum <code>IssueFieldUpdateOperation</code></p>",
+          "<p>Enum value <code>SET</code> was added to enum <code>IssueFieldUpdateOperation</code></p>",
+          "<p>Input field <code>issueFieldUpdates</code> of type '[IssueFieldUpdateInput!]<code>was added to input object type</code>UpdateIssueInput'</p>"
+        ]
+      }
+    ],
+    "previewChanges": [],
+    "upcomingChanges": [],
+    "date": "2026-08-24"
+  },
   {
     "schemaChanges": [
       {
diff --git a/src/graphql/data/fpt/schema-issues.json b/src/graphql/data/fpt/schema-issues.json
index 7dfefa34f677..e92ffa775e25 100644
--- a/src/graphql/data/fpt/schema-issues.json
+++ b/src/graphql/data/fpt/schema-issues.json
@@ -9950,6 +9950,32 @@
       ],
       "category": "issues"
     },
+    {
+      "name": "IssueFieldUpdateOperation",
+      "id": "issuefieldupdateoperation",
+      "href": "/graphql/reference/issues#enum-issuefieldupdateoperation",
+      "description": "<p>The operation to perform on an issue field value.</p>",
+      "isDeprecated": false,
+      "values": [
+        {
+          "name": "ADD",
+          "description": "<p>Sets a scalar field or adds options to a multi-select field.</p>"
+        },
+        {
+          "name": "CLEAR",
+          "description": "<p>Clears the field value.</p>"
+        },
+        {
+          "name": "REMOVE",
+          "description": "<p>Removes options from a multi-select field.</p>"
+        },
+        {
+          "name": "SET",
+          "description": "<p>Replaces the field value.</p>"
+        }
+      ],
+      "category": "issues"
+    },
     {
       "name": "IssueFieldVisibility",
       "id": "issuefieldvisibility",
@@ -12205,6 +12231,37 @@
       ],
       "category": "issues"
     },
+    {
+      "name": "IssueFieldUpdateInput",
+      "id": "issuefieldupdateinput",
+      "href": "/graphql/reference/issues#input-object-issuefieldupdateinput",
+      "description": "<p>Updates an issue field using its user-facing name.</p>",
+      "isDeprecated": false,
+      "inputFields": [
+        {
+          "name": "fieldName",
+          "description": "<p>The name of the issue field.</p>",
+          "type": "String!",
+          "id": "string",
+          "href": "/graphql/reference/other#scalar-string"
+        },
+        {
+          "name": "operation",
+          "description": "<p>The operation to perform.</p>",
+          "type": "IssueFieldUpdateOperation!",
+          "id": "issuefieldupdateoperation",
+          "href": "/graphql/reference/issues#enum-issuefieldupdateoperation"
+        },
+        {
+          "name": "value",
+          "description": "<p>The value or comma-separated option names for the operation.</p>",
+          "type": "String",
+          "id": "string",
+          "href": "/graphql/reference/other#scalar-string"
+        }
+      ],
+      "category": "issues"
+    },
     {
       "name": "IssueFieldValueFilter",
       "id": "issuefieldvaluefilter",
@@ -13399,6 +13456,13 @@
           "href": "/graphql/reference/other#scalar-id",
           "isDeprecated": false
         },
+        {
+          "name": "issueFieldUpdates",
+          "description": "<p>Issue field updates resolved by field and option names.</p>",
+          "type": "[IssueFieldUpdateInput!]",
+          "id": "issuefieldupdateinput",
+          "href": "/graphql/reference/issues#input-object-issuefieldupdateinput"
+        },
         {
           "name": "issueType",
           "description": "<p>The Issue Type to set on this issue, with optional rationale. Mutually exclusive with <code>issueTypeId</code>.</p>",
diff --git a/src/graphql/data/fpt/schema.docs.graphql b/src/graphql/data/fpt/schema.docs.graphql
index 29c6962045b0..023dc8bf1a84 100644
--- a/src/graphql/data/fpt/schema.docs.graphql
+++ b/src/graphql/data/fpt/schema.docs.graphql
@@ -22314,6 +22314,51 @@ type IssueFieldTimelineOption @docsCategory(name: "issues") {
   name: String!
 }
 
+"""
+Updates an issue field using its user-facing name.
+"""
+input IssueFieldUpdateInput @docsCategory(name: "issues") {
+  """
+  The name of the issue field.
+  """
+  fieldName: String!
+
+  """
+  The operation to perform.
+  """
+  operation: IssueFieldUpdateOperation!
+
+  """
+  The value or comma-separated option names for the operation.
+  """
+  value: String
+}
+
+"""
+The operation to perform on an issue field value.
+"""
+enum IssueFieldUpdateOperation @docsCategory(name: "issues") {
+  """
+  Sets a scalar field or adds options to a multi-select field.
+  """
+  ADD
+
+  """
+  Clears the field value.
+  """
+  CLEAR
+
+  """
+  Removes options from a multi-select field.
+  """
+  REMOVE
+
+  """
+  Replaces the field value.
+  """
+  SET
+}
+
 """
 Issue field values
 """
@@ -69937,6 +69982,11 @@ input UpdateIssueInput {
   """
   id: ID! @possibleTypes(concreteTypes: ["Issue"])
 
+  """
+  Issue field updates resolved by field and option names.
+  """
+  issueFieldUpdates: [IssueFieldUpdateInput!]
+
   """
   The Issue Type to set on this issue, with optional rationale. Mutually exclusive with `issueTypeId`.
   """
diff --git a/src/graphql/data/ghec/category-map.json b/src/graphql/data/ghec/category-map.json
index 4d426d9d6e8f..372140eb1444 100644
--- a/src/graphql/data/ghec/category-map.json
+++ b/src/graphql/data/ghec/category-map.json
@@ -1244,6 +1244,7 @@
     "issuefielddatatype": "issues",
     "issuefieldorderfield": "issues",
     "issuefieldsingleselectoptioncolor": "issues",
+    "issuefieldupdateoperation": "issues",
     "issuefieldvisibility": "issues",
     "issueorderfield": "issues",
     "issuesearchtype": "issues",
@@ -1595,6 +1596,7 @@
     "issuefieldcreateorupdateinput": "issues",
     "issuefieldorder": "issues",
     "issuefieldsingleselectoptioninput": "issues",
+    "issuefieldupdateinput": "issues",
     "issuefieldvaluefilter": "issues",
     "issuefilters": "issues",
     "issueorder": "issues",
diff --git a/src/graphql/data/ghec/schema-issues.json b/src/graphql/data/ghec/schema-issues.json
index 7dfefa34f677..e92ffa775e25 100644
--- a/src/graphql/data/ghec/schema-issues.json
+++ b/src/graphql/data/ghec/schema-issues.json
@@ -9950,6 +9950,32 @@
       ],
       "category": "issues"
     },
+    {
+      "name": "IssueFieldUpdateOperation",
+      "id": "issuefieldupdateoperation",
+      "href": "/graphql/reference/issues#enum-issuefieldupdateoperation",
+      "description": "<p>The operation to perform on an issue field value.</p>",
+      "isDeprecated": false,
+      "values": [
+        {
+          "name": "ADD",
+          "description": "<p>Sets a scalar field or adds options to a multi-select field.</p>"
+        },
+        {
+          "name": "CLEAR",
+          "description": "<p>Clears the field value.</p>"
+        },
+        {
+          "name": "REMOVE",
+          "description": "<p>Removes options from a multi-select field.</p>"
+        },
+        {
+          "name": "SET",
+          "description": "<p>Replaces the field value.</p>"
+        }
+      ],
+      "category": "issues"
+    },
     {
       "name": "IssueFieldVisibility",
       "id": "issuefieldvisibility",
@@ -12205,6 +12231,37 @@
       ],
       "category": "issues"
     },
+    {
+      "name": "IssueFieldUpdateInput",
+      "id": "issuefieldupdateinput",
+      "href": "/graphql/reference/issues#input-object-issuefieldupdateinput",
+      "description": "<p>Updates an issue field using its user-facing name.</p>",
+      "isDeprecated": false,
+      "inputFields": [
+        {
+          "name": "fieldName",
+          "description": "<p>The name of the issue field.</p>",
+          "type": "String!",
+          "id": "string",
+          "href": "/graphql/reference/other#scalar-string"
+        },
+        {
+          "name": "operation",
+          "description": "<p>The operation to perform.</p>",
+          "type": "IssueFieldUpdateOperation!",
+          "id": "issuefieldupdateoperation",
+          "href": "/graphql/reference/issues#enum-issuefieldupdateoperation"
+        },
+        {
+          "name": "value",
+          "description": "<p>The value or comma-separated option names for the operation.</p>",
+          "type": "String",
+          "id": "string",
+          "href": "/graphql/reference/other#scalar-string"
+        }
+      ],
+      "category": "issues"
+    },
     {
       "name": "IssueFieldValueFilter",
       "id": "issuefieldvaluefilter",
@@ -13399,6 +13456,13 @@
           "href": "/graphql/reference/other#scalar-id",
           "isDeprecated": false
         },
+        {
+          "name": "issueFieldUpdates",
+          "description": "<p>Issue field updates resolved by field and option names.</p>",
+          "type": "[IssueFieldUpdateInput!]",
+          "id": "issuefieldupdateinput",
+          "href": "/graphql/reference/issues#input-object-issuefieldupdateinput"
+        },
         {
           "name": "issueType",
           "description": "<p>The Issue Type to set on this issue, with optional rationale. Mutually exclusive with <code>issueTypeId</code>.</p>",
diff --git a/src/graphql/data/ghec/schema.docs.graphql b/src/graphql/data/ghec/schema.docs.graphql
index 29c6962045b0..023dc8bf1a84 100644
--- a/src/graphql/data/ghec/schema.docs.graphql
+++ b/src/graphql/data/ghec/schema.docs.graphql
@@ -22314,6 +22314,51 @@ type IssueFieldTimelineOption @docsCategory(name: "issues") {
   name: String!
 }
 
+"""
+Updates an issue field using its user-facing name.
+"""
+input IssueFieldUpdateInput @docsCategory(name: "issues") {
+  """
+  The name of the issue field.
+  """
+  fieldName: String!
+
+  """
+  The operation to perform.
+  """
+  operation: IssueFieldUpdateOperation!
+
+  """
+  The value or comma-separated option names for the operation.
+  """
+  value: String
+}
+
+"""
+The operation to perform on an issue field value.
+"""
+enum IssueFieldUpdateOperation @docsCategory(name: "issues") {
+  """
+  Sets a scalar field or adds options to a multi-select field.
+  """
+  ADD
+
+  """
+  Clears the field value.
+  """
+  CLEAR
+
+  """
+  Removes options from a multi-select field.
+  """
+  REMOVE
+
+  """
+  Replaces the field value.
+  """
+  SET
+}
+
 """
 Issue field values
 """
@@ -69937,6 +69982,11 @@ input UpdateIssueInput {
   """
   id: ID! @possibleTypes(concreteTypes: ["Issue"])
 
+  """
+  Issue field updates resolved by field and option names.
+  """
+  issueFieldUpdates: [IssueFieldUpdateInput!]
+
   """
   The Issue Type to set on this issue, with optional rationale. Mutually exclusive with `issueTypeId`.
   """