Update OpenAPI Description (#58416)

docs-bot · sabrowning1 · web-flow · commit 94aaa9625757 · 2025-11-10T14:00:40.000Z
Co-authored-by: Sam Browning &lt;106113886+sabrowning1@users.noreply.github.com&gt;
diff --git a/content/rest/projects/drafts.md b/content/rest/projects/drafts.md
@@ -0,0 +1,14 @@
+---
+title: REST API endpoints for draft Project items
+shortTitle: Draft Project items
+intro: Use the REST API to manage draft items in Projects.
+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 -->
diff --git a/content/rest/projects/index.md b/content/rest/projects/index.md
@@ -5,6 +5,7 @@ topics:
 autogenerated: rest
 allowTitleToDifferFromFilename: true
 children:
+  - /drafts
   - /fields
   - /items
   - /projects
diff --git a/src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json b/src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json
@@ -2325,6 +2325,15 @@
         "additional-permissions": false,
         "access": "read"
       },
+      {
+        "category": "projects",
+        "slug": "create-draft-item-for-organization-owned-project",
+        "subcategory": "drafts",
+        "verb": "post",
+        "requestPath": "/orgs/{org}/projectsV2/{project_number}/drafts",
+        "additional-permissions": false,
+        "access": "write"
+      },
       {
         "category": "projects",
         "slug": "list-project-fields-for-organization",
diff --git a/src/github-apps/data/fpt-2022-11-28/fine-grained-pat.json b/src/github-apps/data/fpt-2022-11-28/fine-grained-pat.json
@@ -3790,6 +3790,12 @@
       "verb": "get",
       "requestPath": "/orgs/{org}/projectsV2/{project_number}"
     },
+    {
+      "slug": "create-draft-item-for-organization-owned-project",
+      "subcategory": "drafts",
+      "verb": "post",
+      "requestPath": "/orgs/{org}/projectsV2/{project_number}/drafts"
+    },
     {
       "slug": "list-project-fields-for-organization",
       "subcategory": "fields",
diff --git a/src/github-apps/data/fpt-2022-11-28/server-to-server-permissions.json b/src/github-apps/data/fpt-2022-11-28/server-to-server-permissions.json
@@ -2917,6 +2917,17 @@
         "server-to-server": true,
         "additional-permissions": false
       },
+      {
+        "category": "projects",
+        "slug": "create-draft-item-for-organization-owned-project",
+        "subcategory": "drafts",
+        "verb": "post",
+        "requestPath": "/orgs/{org}/projectsV2/{project_number}/drafts",
+        "access": "write",
+        "user-to-server": true,
+        "server-to-server": true,
+        "additional-permissions": false
+      },
       {
         "category": "projects",
         "slug": "list-project-fields-for-organization",
diff --git a/src/github-apps/data/fpt-2022-11-28/server-to-server-rest.json b/src/github-apps/data/fpt-2022-11-28/server-to-server-rest.json
@@ -3886,6 +3886,12 @@
       "verb": "get",
       "requestPath": "/orgs/{org}/projectsV2/{project_number}"
     },
+    {
+      "slug": "create-draft-item-for-organization-owned-project",
+      "subcategory": "drafts",
+      "verb": "post",
+      "requestPath": "/orgs/{org}/projectsV2/{project_number}/drafts"
+    },
     {
       "slug": "list-project-fields-for-organization",
       "subcategory": "fields",
diff --git a/src/github-apps/data/fpt-2022-11-28/user-to-server-rest.json b/src/github-apps/data/fpt-2022-11-28/user-to-server-rest.json
@@ -4366,6 +4366,12 @@
       "verb": "get",
       "requestPath": "/orgs/{org}/projectsV2/{project_number}"
     },
+    {
+      "slug": "create-draft-item-for-organization-owned-project",
+      "subcategory": "drafts",
+      "verb": "post",
+      "requestPath": "/orgs/{org}/projectsV2/{project_number}/drafts"
+    },
     {
       "slug": "list-project-fields-for-organization",
       "subcategory": "fields",
diff --git a/src/github-apps/data/ghec-2022-11-28/fine-grained-pat-permissions.json b/src/github-apps/data/ghec-2022-11-28/fine-grained-pat-permissions.json
@@ -2946,6 +2946,15 @@
         "additional-permissions": false,
         "access": "read"
       },
+      {
+        "category": "projects",
+        "slug": "create-draft-item-for-organization-owned-project",
+        "subcategory": "drafts",
+        "verb": "post",
+        "requestPath": "/orgs/{org}/projectsV2/{project_number}/drafts",
+        "additional-permissions": false,
+        "access": "write"
+      },
       {
         "category": "projects",
         "slug": "list-project-fields-for-organization",
diff --git a/src/github-apps/data/ghec-2022-11-28/fine-grained-pat.json b/src/github-apps/data/ghec-2022-11-28/fine-grained-pat.json
@@ -4064,6 +4064,12 @@
       "verb": "get",
       "requestPath": "/orgs/{org}/projectsV2/{project_number}"
     },
+    {
+      "slug": "create-draft-item-for-organization-owned-project",
+      "subcategory": "drafts",
+      "verb": "post",
+      "requestPath": "/orgs/{org}/projectsV2/{project_number}/drafts"
+    },
     {
       "slug": "list-project-fields-for-organization",
       "subcategory": "fields",
diff --git a/src/github-apps/data/ghec-2022-11-28/server-to-server-permissions.json b/src/github-apps/data/ghec-2022-11-28/server-to-server-permissions.json
@@ -4171,6 +4171,17 @@
         "server-to-server": true,
         "additional-permissions": false
       },
+      {
+        "category": "projects",
+        "slug": "create-draft-item-for-organization-owned-project",
+        "subcategory": "drafts",
+        "verb": "post",
+        "requestPath": "/orgs/{org}/projectsV2/{project_number}/drafts",
+        "access": "write",
+        "user-to-server": true,
+        "server-to-server": true,
+        "additional-permissions": false
+      },
       {
         "category": "projects",
         "slug": "list-project-fields-for-organization",
diff --git a/src/github-apps/data/ghec-2022-11-28/server-to-server-rest.json b/src/github-apps/data/ghec-2022-11-28/server-to-server-rest.json
@@ -4430,6 +4430,12 @@
       "verb": "get",
       "requestPath": "/orgs/{org}/projectsV2/{project_number}"
     },
+    {
+      "slug": "create-draft-item-for-organization-owned-project",
+      "subcategory": "drafts",
+      "verb": "post",
+      "requestPath": "/orgs/{org}/projectsV2/{project_number}/drafts"
+    },
     {
       "slug": "list-project-fields-for-organization",
       "subcategory": "fields",
diff --git a/src/github-apps/data/ghec-2022-11-28/user-to-server-rest.json b/src/github-apps/data/ghec-2022-11-28/user-to-server-rest.json
@@ -4910,6 +4910,12 @@
       "verb": "get",
       "requestPath": "/orgs/{org}/projectsV2/{project_number}"
     },
+    {
+      "slug": "create-draft-item-for-organization-owned-project",
+      "subcategory": "drafts",
+      "verb": "post",
+      "requestPath": "/orgs/{org}/projectsV2/{project_number}/drafts"
+    },
     {
       "slug": "list-project-fields-for-organization",
       "subcategory": "fields",
diff --git a/src/github-apps/lib/config.json b/src/github-apps/lib/config.json
@@ -60,5 +60,5 @@
       "2022-11-28"
     ]
   },
-  "sha": "76075d48c896654c8e9e122ee1e162ccc546ace1"
+  "sha": "0fb9cbe3fd548654115fbe4d8beb758228826ae6"
 }
diff --git a/src/rest/data/fpt-2022-11-28/schema.json b/src/rest/data/fpt-2022-11-28/schema.json
@@ -427847,6 +427847,12 @@
             "description": "<p>The digest of the artifact (algorithm:hex-encoded-digest).</p>",
             "isRequired": true
           },
+          {
+            "type": "string",
+            "name": "version",
+            "in": "body",
+            "description": "<p>The artifact version.</p>"
+          },
           {
             "type": "string",
             "name": "artifact_url",
@@ -427900,7 +427906,8 @@
               "description": "Example",
               "acceptHeader": "application/vnd.github.v3+json",
               "bodyParameters": {
-                "name": "libfoo-1.2.3",
+                "name": "libfoo",
+                "version": "1.2.3",
                 "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72",
                 "artifact_url": "https://reg.example.com/artifactory/bar/libfoo-1.2.3",
                 "registry_url": "https://reg.example.com/artifactory/",
@@ -427919,7 +427926,7 @@
                 "total_count": 1,
                 "storage_records": [
                   {
-                    "name": "libfoo-1.2.3",
+                    "name": "libfoo",
                     "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72",
                     "artifact_url": "https://reg.example.com/artifactory/bar/libfoo-1.2.3",
                     "registry_url": "https://reg.example.com/artifactory/",
@@ -476545,6 +476552,83 @@
         }
       }
     ],
+    "drafts": [
+      {
+        "serverUrl": "https://api.github.com",
+        "verb": "post",
+        "requestPath": "/orgs/{org}/projectsV2/{project_number}/drafts",
+        "title": "Create draft item for organization owned project",
+        "category": "projects",
+        "subcategory": "drafts",
+        "parameters": [
+          {
+            "name": "org",
+            "description": "<p>The organization name. The name is not case sensitive.</p>",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "project_number",
+            "description": "<p>The project's number.</p>",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            }
+          }
+        ],
+        "bodyParameters": [
+          {
+            "type": "string",
+            "name": "title",
+            "in": "body",
+            "description": "<p>The title of the draft issue item to create in the project.</p>",
+            "isRequired": true
+          },
+          {
+            "type": "string",
+            "name": "body",
+            "in": "body",
+            "description": "<p>The body content of the draft issue item to create in the project.</p>"
+          }
+        ],
+        "descriptionHTML": "<p>Create draft issue item for the specified organization owned project.</p>",
+        "codeExamples": [],
+        "statusCodes": [
+          {
+            "httpStatusCode": "201",
+            "description": "<p>Created</p>"
+          },
+          {
+            "httpStatusCode": "304",
+            "description": "<p>Not modified</p>"
+          },
+          {
+            "httpStatusCode": "401",
+            "description": "<p>Requires authentication</p>"
+          },
+          {
+            "httpStatusCode": "403",
+            "description": "<p>Forbidden</p>"
+          }
+        ],
+        "previews": [],
+        "progAccess": {
+          "userToServerRest": true,
+          "serverToServer": true,
+          "fineGrainedPat": true,
+          "permissions": [
+            {
+              "\"Projects\" organization permissions": "write"
+            }
+          ],
+          "allowsPublicRead": true
+        }
+      }
+    ],
     "fields": [
       {
         "serverUrl": "https://api.github.com",
diff --git a/src/rest/data/ghec-2022-11-28/schema.json b/src/rest/data/ghec-2022-11-28/schema.json
diff --git a/src/rest/lib/config.json b/src/rest/lib/config.json
diff --git a/src/webhooks/lib/config.json b/src/webhooks/lib/config.json
