Merge pull request #5583 from github/openapi-update-885e7e3c51c20bf4859b235031a27dfb2fe0c196b9c797ae4215b486c31abe6a

Update OpenAPI 3.0 Descriptions

Author: nickfloyd

descriptions/api.github.com/api.github.com.2022-11-28.json

@@ -73228,6 +73228,99 @@
         }
       }
     },
+    "/user/{user_id}/projectsV2/{project_number}/drafts": {
+      "post": {
+        "summary": "Create draft item for user owned project",
+        "description": "Create draft issue item for the specified user owned project.",
+        "tags": [
+          "projects"
+        ],
+        "operationId": "projects/create-draft-item-for-authenticated-user",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/projects/drafts#create-draft-item-for-user-owned-project"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/user-id"
+          },
+          {
+            "$ref": "#/components/parameters/project-number"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "description": "Details of the draft item to create in the project.",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "title": {
+                    "type": "string",
+                    "description": "The title of the draft issue item to create in the project."
+                  },
+                  "body": {
+                    "type": "string",
+                    "description": "The body content of the draft issue item to create in the project."
+                  }
+                },
+                "required": [
+                  "title"
+                ]
+              },
+              "examples": {
+                "title": {
+                  "summary": "Example with Sample Draft Issue Title",
+                  "value": {
+                    "title": "Sample Draft Issue Title"
+                  }
+                },
+                "body": {
+                  "summary": "Example with Sample Draft Issue Title and Body",
+                  "value": {
+                    "title": "Sample Draft Issue Title",
+                    "body": "This is the body content of the draft issue."
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/projects-v2-item-simple"
+                },
+                "examples": {
+                  "draft_issue": {
+                    "$ref": "#/components/examples/projects-v2-item-simple"
+                  }
+                }
+              }
+            }
+          },
+          "304": {
+            "$ref": "#/components/responses/not_modified"
+          },
+          "403": {
+            "$ref": "#/components/responses/forbidden"
+          },
+          "401": {
+            "$ref": "#/components/responses/requires_authentication"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "projects",
+          "subcategory": "drafts"
+        }
+      }
+    },
     "/users": {
       "get": {
         "summary": "List users",
@@ -310709,6 +310802,15 @@
           ],
           "default": "created"
         }
+      },
+      "user-id": {
+        "name": "user_id",
+        "description": "The unique identifier of the user.",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "type": "string"
+        }
       }
     },
     "responses": {

descriptions/api.github.com/api.github.com.2022-11-28.yaml

@@ -53180,6 +53180,68 @@ paths:
         enabledForGitHubApps: true
         category: users
         subcategory: users
+  "/user/{user_id}/projectsV2/{project_number}/drafts":
+    post:
+      summary: Create draft item for user owned project
+      description: Create draft issue item for the specified user owned project.
+      tags:
+      - projects
+      operationId: projects/create-draft-item-for-authenticated-user
+      externalDocs:
+        description: API method documentation
+        url: https://docs.github.com/rest/projects/drafts#create-draft-item-for-user-owned-project
+      parameters:
+      - "$ref": "#/components/parameters/user-id"
+      - "$ref": "#/components/parameters/project-number"
+      requestBody:
+        required: true
+        description: Details of the draft item to create in the project.
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                title:
+                  type: string
+                  description: The title of the draft issue item to create in the
+                    project.
+                body:
+                  type: string
+                  description: The body content of the draft issue item to create
+                    in the project.
+              required:
+              - title
+            examples:
+              title:
+                summary: Example with Sample Draft Issue Title
+                value:
+                  title: Sample Draft Issue Title
+              body:
+                summary: Example with Sample Draft Issue Title and Body
+                value:
+                  title: Sample Draft Issue Title
+                  body: This is the body content of the draft issue.
+      responses:
+        '201':
+          description: Response
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/projects-v2-item-simple"
+              examples:
+                draft_issue:
+                  "$ref": "#/components/examples/projects-v2-item-simple"
+        '304':
+          "$ref": "#/components/responses/not_modified"
+        '403':
+          "$ref": "#/components/responses/forbidden"
+        '401':
+          "$ref": "#/components/responses/requires_authentication"
+      x-github:
+        githubCloudOnly: false
+        enabledForGitHubApps: true
+        category: projects
+        subcategory: drafts
   "/users":
     get:
       summary: List users
@@ -235996,6 +236058,13 @@ components:
         - created
         - updated
         default: created
+    user-id:
+      name: user_id
+      description: The unique identifier of the user.
+      in: path
+      required: true
+      schema:
+        type: string
   responses:
     validation_failed_simple:
       description: Validation failed, or the endpoint has been spammed.