Merge pull request #1536 from github/openapi-update-21010ab7d5f095a70727eed57e9d743e8c2319373c21b8716a4adbb957da055a

Update OpenAPI 3.0 Descriptions

Author: timrogers

descriptions/api.github.com/api.github.com.json

@@ -15408,6 +15408,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": {
@@ -15422,6 +15437,15 @@
                 }
               }
             }
+          },
+          "404": {
+            "$ref": "#/components/responses/not_found"
+          },
+          "422": {
+            "$ref": "#/components/responses/validation_failed"
+          },
+          "403": {
+            "$ref": "#/components/responses/forbidden"
           }
         },
         "x-github": {
@@ -30576,6 +30600,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/api.github.com/api.github.com.yaml

@@ -11143,6 +11143,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:
@@ -11152,6 +11161,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
@@ -22126,6 +22141,7 @@ paths:
           the format `{base}...{head}`.
         in: path
         required: true
+        x-multi-segment: true
         schema:
           type: string
       responses: