Sync REST API schema to 2026-03-10 + hardcode 2022-11-28 initial version (#60170)

Author: Ebonsignori

content/rest/issues/index.md

@@ -16,8 +16,9 @@ children:
   - /assignees
   - /comments
   - /events
-  - /issues
   - /issue-dependencies
+  - /issue-field-values
+  - /issues
   - /labels
   - /milestones
   - /sub-issues

content/rest/issues/issue-field-values.md

@@ -0,0 +1,15 @@
+---
+title: REST API endpoints for issue field values
+shortTitle: Issue field values
+intro: Use the REST API to view and manage issue field values for issues.
+versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖
+  fpt: '*'
+  ghec: '*'
+  ghes: '*'
+topics:
+  - API
+autogenerated: rest
+allowTitleToDifferFromFilename: true
+---
+
+<!-- Content after this section is automatically generated -->

content/rest/orgs/index.md

@@ -21,6 +21,7 @@ children:
   - /custom-properties
   - /custom-properties-for-orgs
   - /custom-roles
+  - /issue-fields
   - /issue-types
   - /members
   - /network-configurations

content/rest/orgs/issue-fields.md

@@ -0,0 +1,14 @@
+---
+title: REST API endpoints for issue fields
+shortTitle: Issue fields
+intro: Use the REST API to create and manage issue fields for an organization.
+versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖
+  fpt: '*'
+  ghec: '*'
+topics:
+  - API
+autogenerated: rest
+allowTitleToDifferFromFilename: true
+---
+
+<!-- Content after this section is automatically generated -->

data/reusables/rest-api/breaking-changes-changelog.md

@@ -123,7 +123,7 @@ describe('REST transformer', () => {
     expect(res.statusCode).toBe(200)
 
     // Check for API version header in curl example
-    expect(res.body).toContain('-H "X-GitHub-Api-Version: 2022-11-28"')
+    expect(res.body).toContain('-H "X-GitHub-Api-Version: 2026-03-10"')
   })
 
   test('Code examples include specified API version', async () => {
@@ -233,7 +233,7 @@ describe('REST transformer', () => {
 
     expect(res.statusCode).toBe(200)
     // Should include the default API version header
-    expect(res.body).toContain('-H "X-GitHub-Api-Version: 2022-11-28"')
+    expect(res.body).toContain('-H "X-GitHub-Api-Version: 2026-03-10"')
   })
 
   test('Multiple operations on a page are all rendered', async () => {

src/article-api/tests/rest-transformer.ts

@@ -1328,6 +1328,48 @@
       }
     ]
   },
+  "issue_fields": {
+    "title": "Issue Fields",
+    "displayTitle": "Organization permissions for \"Issue Fields\"",
+    "permissions": [
+      {
+        "category": "orgs",
+        "slug": "list-issue-fields-for-an-organization",
+        "subcategory": "issue-fields",
+        "verb": "get",
+        "requestPath": "/orgs/{org}/issue-fields",
+        "additional-permissions": false,
+        "access": "read"
+      },
+      {
+        "category": "orgs",
+        "slug": "create-issue-field-for-an-organization",
+        "subcategory": "issue-fields",
+        "verb": "post",
+        "requestPath": "/orgs/{org}/issue-fields",
+        "additional-permissions": false,
+        "access": "write"
+      },
+      {
+        "category": "orgs",
+        "slug": "update-issue-field-for-an-organization",
+        "subcategory": "issue-fields",
+        "verb": "patch",
+        "requestPath": "/orgs/{org}/issue-fields/{issue_field_id}",
+        "additional-permissions": false,
+        "access": "write"
+      },
+      {
+        "category": "orgs",
+        "slug": "delete-issue-field-for-an-organization",
+        "subcategory": "issue-fields",
+        "verb": "delete",
+        "requestPath": "/orgs/{org}/issue-fields/{issue_field_id}",
+        "additional-permissions": false,
+        "access": "write"
+      }
+    ]
+  },
   "issue_types": {
     "title": "Issue Types",
     "displayTitle": "Organization permissions for \"Issue Types\"",
@@ -6348,6 +6390,15 @@
         "additional-permissions": true,
         "access": "read"
       },
+      {
+        "category": "issues",
+        "slug": "list-issue-field-values-for-an-issue",
+        "subcategory": "issue-field-values",
+        "verb": "get",
+        "requestPath": "/repos/{owner}/{repo}/issues/{issue_number}/issue-field-values",
+        "additional-permissions": false,
+        "access": "read"
+      },
       {
         "category": "issues",
         "slug": "list-labels-for-an-issue",
@@ -6590,6 +6641,33 @@
         "requestPath": "/repos/{owner}/{repo}/milestones/{milestone_number}/labels",
         "additional-permissions": true,
         "access": "read"
+      },
+      {
+        "category": "issues",
+        "slug": "add-issue-field-values-to-an-issue",
+        "subcategory": "issue-field-values",
+        "verb": "post",
+        "requestPath": "/repositories/{repository_id}/issues/{issue_number}/issue-field-values",
+        "additional-permissions": true,
+        "access": "write"
+      },
+      {
+        "category": "issues",
+        "slug": "set-issue-field-values-for-an-issue",
+        "subcategory": "issue-field-values",
+        "verb": "put",
+        "requestPath": "/repositories/{repository_id}/issues/{issue_number}/issue-field-values",
+        "additional-permissions": true,
+        "access": "write"
+      },
+      {
+        "category": "issues",
+        "slug": "delete-an-issue-field-value-from-an-issue",
+        "subcategory": "issue-field-values",
+        "verb": "delete",
+        "requestPath": "/repositories/{repository_id}/issues/{issue_number}/issue-field-values/{issue_field_id}",
+        "additional-permissions": true,
+        "access": "write"
       }
     ]
   },
@@ -7571,6 +7649,33 @@
         "requestPath": "/repos/{owner}/{repo}/pulls/{pull_number}/update-branch",
         "additional-permissions": false,
         "access": "write"
+      },
+      {
+        "category": "issues",
+        "slug": "add-issue-field-values-to-an-issue",
+        "subcategory": "issue-field-values",
+        "verb": "post",
+        "requestPath": "/repositories/{repository_id}/issues/{issue_number}/issue-field-values",
+        "additional-permissions": true,
+        "access": "write"
+      },
+      {
+        "category": "issues",
+        "slug": "set-issue-field-values-for-an-issue",
+        "subcategory": "issue-field-values",
+        "verb": "put",
+        "requestPath": "/repositories/{repository_id}/issues/{issue_number}/issue-field-values",
+        "additional-permissions": true,
+        "access": "write"
+      },
+      {
+        "category": "issues",
+        "slug": "delete-an-issue-field-value-from-an-issue",
+        "subcategory": "issue-field-values",
+        "verb": "delete",
+        "requestPath": "/repositories/{repository_id}/issues/{issue_number}/issue-field-values/{issue_field_id}",
+        "additional-permissions": true,
+        "access": "write"
       }
     ]
   },

src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json

@@ -2820,6 +2820,12 @@
       "verb": "get",
       "requestPath": "/repos/{owner}/{repo}/issues/{issue_number}/events"
     },
+    {
+      "slug": "list-issue-field-values-for-an-issue",
+      "subcategory": "issue-field-values",
+      "verb": "get",
+      "requestPath": "/repos/{owner}/{repo}/issues/{issue_number}/issue-field-values"
+    },
     {
       "slug": "list-labels-for-an-issue",
       "subcategory": "labels",
@@ -2963,6 +2969,24 @@
       "subcategory": "labels",
       "verb": "get",
       "requestPath": "/repos/{owner}/{repo}/milestones/{milestone_number}/labels"
+    },
+    {
+      "slug": "add-issue-field-values-to-an-issue",
+      "subcategory": "issue-field-values",
+      "verb": "post",
+      "requestPath": "/repositories/{repository_id}/issues/{issue_number}/issue-field-values"
+    },
+    {
+      "slug": "set-issue-field-values-for-an-issue",
+      "subcategory": "issue-field-values",
+      "verb": "put",
+      "requestPath": "/repositories/{repository_id}/issues/{issue_number}/issue-field-values"
+    },
+    {
+      "slug": "delete-an-issue-field-value-from-an-issue",
+      "subcategory": "issue-field-values",
+      "verb": "delete",
+      "requestPath": "/repositories/{repository_id}/issues/{issue_number}/issue-field-values/{issue_field_id}"
     }
   ],
   "licenses": [
@@ -3340,6 +3364,30 @@
       "verb": "get",
       "requestPath": "/orgs/{org}/invitations/{invitation_id}/teams"
     },
+    {
+      "slug": "list-issue-fields-for-an-organization",
+      "subcategory": "issue-fields",
+      "verb": "get",
+      "requestPath": "/orgs/{org}/issue-fields"
+    },
+    {
+      "slug": "create-issue-field-for-an-organization",
+      "subcategory": "issue-fields",
+      "verb": "post",
+      "requestPath": "/orgs/{org}/issue-fields"
+    },
+    {
+      "slug": "update-issue-field-for-an-organization",
+      "subcategory": "issue-fields",
+      "verb": "patch",
+      "requestPath": "/orgs/{org}/issue-fields/{issue_field_id}"
+    },
+    {
+      "slug": "delete-issue-field-for-an-organization",
+      "subcategory": "issue-fields",
+      "verb": "delete",
+      "requestPath": "/orgs/{org}/issue-fields/{issue_field_id}"
+    },
     {
       "slug": "list-issue-types-for-an-organization",
       "subcategory": "issue-types",