Merge pull request #1535 from github/openapi-update-888047707c78a9f1a791d2f6a6b006a5d2c181f26cc1bfb483fcd5c7bf8fcba0

Update OpenAPI 3.1 Descriptions

Author: timrogers

descriptions-next/api.github.com/api.github.com.json

@@ -15480,6 +15480,21 @@
           }
         },
         "responses": {
+          "200": {
+            "description": "Response when the updated information already exists",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/team-full"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/team-full"
+                  }
+                }
+              }
+            }
+          },
           "201": {
             "description": "Response",
             "content": {
@@ -15494,6 +15509,15 @@
                 }
               }
             }
+          },
+          "404": {
+            "$ref": "#/components/responses/not_found"
+          },
+          "422": {
+            "$ref": "#/components/responses/validation_failed"
+          },
+          "403": {
+            "$ref": "#/components/responses/forbidden"
           }
         },
         "x-github": {
@@ -30726,6 +30750,7 @@
             "description": "The base branch and head branch to compare. This parameter expects the format `{base}...{head}`.",
             "in": "path",
             "required": true,
+            "x-multi-segment": true,
             "schema": {
               "type": "string"
             }

descriptions-next/api.github.com/api.github.com.yaml

@@ -11177,6 +11177,15 @@ paths:
                   description: new team description
                   privacy: closed
       responses:
+        '200':
+          description: Response when the updated information already exists
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/team-full"
+              examples:
+                default:
+                  "$ref": "#/components/examples/team-full"
         '201':
           description: Response
           content:
@@ -11186,6 +11195,12 @@ paths:
               examples:
                 default:
                   "$ref": "#/components/examples/team-full"
+        '404':
+          "$ref": "#/components/responses/not_found"
+        '422':
+          "$ref": "#/components/responses/validation_failed"
+        '403':
+          "$ref": "#/components/responses/forbidden"
       x-github:
         githubCloudOnly: false
         enabledForGitHubApps: true
@@ -22198,6 +22213,7 @@ paths:
           the format `{base}...{head}`.
         in: path
         required: true
+        x-multi-segment: true
         schema:
           type: string
       responses: