From 9a7b3a9ccb983af5df2cd94da7fecf7a8237529b Mon Sep 17 00:00:00 2001
From: github-openapi-bot
 <69533958+github-openapi-bot@users.noreply.github.com>
Date: Thu, 8 Sep 2022 21:52:15 -0700
Subject: [PATCH] Update OpenAPI  Descriptions (#30632)

---
 lib/rest/static/decorated/api.github.com.json | 709 ++++++++++++++-
 lib/rest/static/decorated/ghes-3.2.json       | 693 ++++++++++++++-
 lib/rest/static/decorated/ghes-3.3.json       | 693 ++++++++++++++-
 lib/rest/static/decorated/ghes-3.4.json       | 702 ++++++++++++++-
 lib/rest/static/decorated/ghes-3.5.json       | 702 ++++++++++++++-
 lib/rest/static/decorated/ghes-3.6.json       | 708 ++++++++++++++-
 lib/rest/static/decorated/github.ae.json      | 709 ++++++++++++++-
 .../dereferenced/api.github.com.deref.json    | 807 ++++++++++++++++++
 .../static/dereferenced/ghes-3.2.deref.json   | 791 +++++++++++++++++
 .../static/dereferenced/ghes-3.3.deref.json   | 791 +++++++++++++++++
 .../static/dereferenced/ghes-3.4.deref.json   | 800 +++++++++++++++++
 .../static/dereferenced/ghes-3.5.deref.json   | 800 +++++++++++++++++
 .../static/dereferenced/ghes-3.6.deref.json   | 806 +++++++++++++++++
 .../static/dereferenced/github.ae.deref.json  | 807 ++++++++++++++++++
 14 files changed, 10511 insertions(+), 7 deletions(-)

diff --git a/lib/rest/static/decorated/api.github.com.json b/lib/rest/static/decorated/api.github.com.json
index 48db21978f..25ed1d04c9 100644
--- a/lib/rest/static/decorated/api.github.com.json
+++ b/lib/rest/static/decorated/api.github.com.json
@@ -254919,6 +254919,7 @@
             "description": "<p>The base branch and head branch to compare. This parameter expects the format <code>{base}...{head}</code>.</p>",
             "in": "path",
             "required": true,
+            "x-multi-segment": true,
             "schema": {
               "type": "string"
             }
@@ -547315,7 +547316,697 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Example 1: Status Code 200",
+              "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "name": "new team name",
+                "description": "new team description",
+                "privacy": "closed"
+              },
+              "parameters": {
+                "org": "ORG",
+                "team_slug": "TEAM_SLUG"
+              }
+            },
+            "response": {
+              "statusCode": "200",
+              "contentType": "application/json",
+              "description": "<p>Response when the updated information already exists</p>",
+              "example": {
+                "id": 1,
+                "node_id": "MDQ6VGVhbTE=",
+                "url": "https://api.github.com/teams/1",
+                "html_url": "https://github.com/orgs/github/teams/justice-league",
+                "name": "Justice League",
+                "slug": "justice-league",
+                "description": "A great team.",
+                "privacy": "closed",
+                "permission": "admin",
+                "members_url": "https://api.github.com/teams/1/members{/member}",
+                "repositories_url": "https://api.github.com/teams/1/repos",
+                "parent": null,
+                "members_count": 3,
+                "repos_count": 10,
+                "created_at": "2017-07-14T16:53:42Z",
+                "updated_at": "2017-08-17T12:37:15Z",
+                "organization": {
+                  "login": "github",
+                  "id": 1,
+                  "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
+                  "url": "https://api.github.com/orgs/github",
+                  "repos_url": "https://api.github.com/orgs/github/repos",
+                  "events_url": "https://api.github.com/orgs/github/events",
+                  "hooks_url": "https://api.github.com/orgs/github/hooks",
+                  "issues_url": "https://api.github.com/orgs/github/issues",
+                  "members_url": "https://api.github.com/orgs/github/members{/member}",
+                  "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
+                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+                  "description": "A great organization",
+                  "name": "github",
+                  "company": "GitHub",
+                  "blog": "https://github.com/blog",
+                  "location": "San Francisco",
+                  "email": "octocat@github.com",
+                  "is_verified": true,
+                  "has_organization_projects": true,
+                  "has_repository_projects": true,
+                  "public_repos": 2,
+                  "public_gists": 1,
+                  "followers": 20,
+                  "following": 0,
+                  "html_url": "https://github.com/octocat",
+                  "created_at": "2008-01-14T04:33:35Z",
+                  "updated_at": "2017-08-17T12:37:15Z",
+                  "type": "Organization"
+                }
+              },
+              "schema": {
+                "title": "Full Team",
+                "description": "Groups of organization members that gives permissions on specified repositories.",
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "description": "Unique identifier of the team",
+                    "type": "integer",
+                    "examples": [
+                      42
+                    ]
+                  },
+                  "node_id": {
+                    "type": "string",
+                    "examples": [
+                      "MDQ6VGVhbTE="
+                    ]
+                  },
+                  "url": {
+                    "description": "URL for the team",
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1"
+                    ]
+                  },
+                  "html_url": {
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://github.com/orgs/rails/teams/core"
+                    ]
+                  },
+                  "name": {
+                    "description": "Name of the team",
+                    "type": "string",
+                    "examples": [
+                      "Developers"
+                    ]
+                  },
+                  "slug": {
+                    "type": "string",
+                    "examples": [
+                      "justice-league"
+                    ]
+                  },
+                  "description": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "examples": [
+                      "A great team."
+                    ]
+                  },
+                  "privacy": {
+                    "description": "The level of privacy this team should have",
+                    "type": "string",
+                    "enum": [
+                      "closed",
+                      "secret"
+                    ],
+                    "examples": [
+                      "closed"
+                    ]
+                  },
+                  "permission": {
+                    "description": "Permission that the team will have for its repositories",
+                    "type": "string",
+                    "examples": [
+                      "push"
+                    ]
+                  },
+                  "members_url": {
+                    "type": "string",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1/members{/member}"
+                    ]
+                  },
+                  "repositories_url": {
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1/repos"
+                    ]
+                  },
+                  "parent": {
+                    "anyOf": [
+                      {
+                        "type": "null"
+                      },
+                      {
+                        "title": "Team Simple",
+                        "description": "Groups of organization members that gives permissions on specified repositories.",
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "description": "Unique identifier of the team",
+                            "type": "integer",
+                            "examples": [
+                              1
+                            ]
+                          },
+                          "node_id": {
+                            "type": "string",
+                            "examples": [
+                              "MDQ6VGVhbTE="
+                            ]
+                          },
+                          "url": {
+                            "description": "URL for the team",
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1"
+                            ]
+                          },
+                          "members_url": {
+                            "type": "string",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1/members{/member}"
+                            ]
+                          },
+                          "name": {
+                            "description": "Name of the team",
+                            "type": "string",
+                            "examples": [
+                              "Justice League"
+                            ]
+                          },
+                          "description": {
+                            "description": "Description of the team",
+                            "type": [
+                              "string",
+                              "null"
+                            ],
+                            "examples": [
+                              "A great team."
+                            ]
+                          },
+                          "permission": {
+                            "description": "Permission that the team will have for its repositories",
+                            "type": "string",
+                            "examples": [
+                              "admin"
+                            ]
+                          },
+                          "privacy": {
+                            "description": "The level of privacy this team should have",
+                            "type": "string",
+                            "examples": [
+                              "closed"
+                            ]
+                          },
+                          "html_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://github.com/orgs/rails/teams/core"
+                            ]
+                          },
+                          "repositories_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1/repos"
+                            ]
+                          },
+                          "slug": {
+                            "type": "string",
+                            "examples": [
+                              "justice-league"
+                            ]
+                          },
+                          "ldap_dn": {
+                            "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                            "type": "string",
+                            "examples": [
+                              "uid=example,ou=users,dc=github,dc=com"
+                            ]
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "node_id",
+                          "url",
+                          "members_url",
+                          "name",
+                          "description",
+                          "permission",
+                          "html_url",
+                          "repositories_url",
+                          "slug"
+                        ]
+                      }
+                    ]
+                  },
+                  "members_count": {
+                    "type": "integer",
+                    "examples": [
+                      3
+                    ]
+                  },
+                  "repos_count": {
+                    "type": "integer",
+                    "examples": [
+                      10
+                    ]
+                  },
+                  "created_at": {
+                    "type": "string",
+                    "format": "date-time",
+                    "examples": [
+                      "2017-07-14T16:53:42Z"
+                    ]
+                  },
+                  "updated_at": {
+                    "type": "string",
+                    "format": "date-time",
+                    "examples": [
+                      "2017-08-17T12:37:15Z"
+                    ]
+                  },
+                  "organization": {
+                    "title": "Team Organization",
+                    "description": "Team Organization",
+                    "type": "object",
+                    "properties": {
+                      "login": {
+                        "type": "string",
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "id": {
+                        "type": "integer",
+                        "examples": [
+                          1
+                        ]
+                      },
+                      "node_id": {
+                        "type": "string",
+                        "examples": [
+                          "MDEyOk9yZ2FuaXphdGlvbjE="
+                        ]
+                      },
+                      "url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github"
+                        ]
+                      },
+                      "repos_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github/repos"
+                        ]
+                      },
+                      "events_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github/events"
+                        ]
+                      },
+                      "hooks_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/hooks"
+                        ]
+                      },
+                      "issues_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/issues"
+                        ]
+                      },
+                      "members_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/members{/member}"
+                        ]
+                      },
+                      "public_members_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/public_members{/member}"
+                        ]
+                      },
+                      "avatar_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://github.com/images/error/octocat_happy.gif"
+                        ]
+                      },
+                      "description": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "examples": [
+                          "A great organization"
+                        ]
+                      },
+                      "name": {
+                        "type": "string",
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "company": {
+                        "type": "string",
+                        "examples": [
+                          "GitHub"
+                        ]
+                      },
+                      "blog": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://github.com/blog"
+                        ]
+                      },
+                      "location": {
+                        "type": "string",
+                        "examples": [
+                          "San Francisco"
+                        ]
+                      },
+                      "email": {
+                        "type": "string",
+                        "format": "email",
+                        "examples": [
+                          "octocat@github.com"
+                        ]
+                      },
+                      "twitter_username": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "is_verified": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "has_organization_projects": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "has_repository_projects": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "public_repos": {
+                        "type": "integer",
+                        "examples": [
+                          2
+                        ]
+                      },
+                      "public_gists": {
+                        "type": "integer",
+                        "examples": [
+                          1
+                        ]
+                      },
+                      "followers": {
+                        "type": "integer",
+                        "examples": [
+                          20
+                        ]
+                      },
+                      "following": {
+                        "type": "integer",
+                        "examples": [
+                          0
+                        ]
+                      },
+                      "html_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://github.com/octocat"
+                        ]
+                      },
+                      "created_at": {
+                        "type": "string",
+                        "format": "date-time",
+                        "examples": [
+                          "2008-01-14T04:33:35Z"
+                        ]
+                      },
+                      "type": {
+                        "type": "string",
+                        "examples": [
+                          "Organization"
+                        ]
+                      },
+                      "total_private_repos": {
+                        "type": "integer",
+                        "examples": [
+                          100
+                        ]
+                      },
+                      "owned_private_repos": {
+                        "type": "integer",
+                        "examples": [
+                          100
+                        ]
+                      },
+                      "private_gists": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          81
+                        ]
+                      },
+                      "disk_usage": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          10000
+                        ]
+                      },
+                      "collaborators": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          8
+                        ]
+                      },
+                      "billing_email": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "format": "email",
+                        "examples": [
+                          "org@example.com"
+                        ]
+                      },
+                      "plan": {
+                        "type": "object",
+                        "properties": {
+                          "name": {
+                            "type": "string"
+                          },
+                          "space": {
+                            "type": "integer"
+                          },
+                          "private_repos": {
+                            "type": "integer"
+                          },
+                          "filled_seats": {
+                            "type": "integer"
+                          },
+                          "seats": {
+                            "type": "integer"
+                          }
+                        },
+                        "required": [
+                          "name",
+                          "space",
+                          "private_repos"
+                        ]
+                      },
+                      "default_repository_permission": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "members_can_create_repositories": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "two_factor_requirement_enabled": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_allowed_repository_creation_type": {
+                        "type": "string",
+                        "examples": [
+                          "all"
+                        ]
+                      },
+                      "members_can_create_public_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_private_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_internal_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_public_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_private_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_fork_private_repositories": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          false
+                        ]
+                      },
+                      "web_commit_signoff_required": {
+                        "type": "boolean",
+                        "examples": [
+                          false
+                        ]
+                      },
+                      "updated_at": {
+                        "type": "string",
+                        "format": "date-time"
+                      }
+                    },
+                    "required": [
+                      "login",
+                      "url",
+                      "id",
+                      "node_id",
+                      "repos_url",
+                      "events_url",
+                      "hooks_url",
+                      "issues_url",
+                      "members_url",
+                      "public_members_url",
+                      "avatar_url",
+                      "description",
+                      "html_url",
+                      "has_organization_projects",
+                      "has_repository_projects",
+                      "public_repos",
+                      "public_gists",
+                      "followers",
+                      "following",
+                      "type",
+                      "created_at",
+                      "updated_at"
+                    ]
+                  },
+                  "ldap_dn": {
+                    "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                    "type": "string",
+                    "examples": [
+                      "uid=example,ou=users,dc=github,dc=com"
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "node_id",
+                  "url",
+                  "members_url",
+                  "name",
+                  "description",
+                  "permission",
+                  "html_url",
+                  "repositories_url",
+                  "slug",
+                  "created_at",
+                  "updated_at",
+                  "members_count",
+                  "repos_count",
+                  "organization"
+                ]
+              }
+            }
+          },
+          {
+            "key": "default",
+            "request": {
+              "contentType": "application/json",
+              "description": "Example 2: Status Code 201",
               "acceptHeader": "application/vnd.github.v3+json",
               "bodyParameters": {
                 "name": "new team name",
@@ -548005,9 +548696,25 @@
         "previews": [],
         "descriptionHTML": "<p>To edit a team, the authenticated user must either be an organization owner or a team maintainer.</p>\n<p><strong>Note:</strong> You can also specify a team by <code>org_id</code> and <code>team_id</code> using the route <code>PATCH /organizations/{org_id}/team/{team_id}</code>.</p>",
         "statusCodes": [
+          {
+            "httpStatusCode": "200",
+            "description": "<p>Response when the updated information already exists</p>"
+          },
           {
             "httpStatusCode": "201",
             "description": "<p>Created</p>"
+          },
+          {
+            "httpStatusCode": "403",
+            "description": "<p>Forbidden</p>"
+          },
+          {
+            "httpStatusCode": "404",
+            "description": "<p>Resource not found</p>"
+          },
+          {
+            "httpStatusCode": "422",
+            "description": "<p>Validation failed</p>"
           }
         ],
         "subcategory": "teams"
diff --git a/lib/rest/static/decorated/ghes-3.2.json b/lib/rest/static/decorated/ghes-3.2.json
index 59a2c58f02..65a1f6cb32 100644
--- a/lib/rest/static/decorated/ghes-3.2.json
+++ b/lib/rest/static/decorated/ghes-3.2.json
@@ -178597,6 +178597,7 @@
             "description": "<p>The base branch and head branch to compare. This parameter expects the format <code>{base}...{head}</code>.</p>",
             "in": "path",
             "required": true,
+            "x-multi-segment": true,
             "schema": {
               "type": "string"
             }
@@ -431140,7 +431141,681 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Example 1: Status Code 200",
+              "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "name": "new team name",
+                "description": "new team description",
+                "privacy": "closed"
+              },
+              "parameters": {
+                "org": "ORG",
+                "team_slug": "TEAM_SLUG"
+              }
+            },
+            "response": {
+              "statusCode": "200",
+              "contentType": "application/json",
+              "description": "<p>Response when the updated information already exists</p>",
+              "example": {
+                "id": 1,
+                "node_id": "MDQ6VGVhbTE=",
+                "url": "https://api.github.com/teams/1",
+                "html_url": "https://github.com/orgs/github/teams/justice-league",
+                "name": "Justice League",
+                "slug": "justice-league",
+                "description": "A great team.",
+                "privacy": "closed",
+                "permission": "admin",
+                "members_url": "https://api.github.com/teams/1/members{/member}",
+                "repositories_url": "https://api.github.com/teams/1/repos",
+                "members_count": 3,
+                "repos_count": 10,
+                "created_at": "2017-07-14T16:53:42Z",
+                "updated_at": "2017-08-17T12:37:15Z",
+                "organization": {
+                  "login": "github",
+                  "id": 1,
+                  "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
+                  "url": "https://api.github.com/orgs/github",
+                  "repos_url": "https://api.github.com/orgs/github/repos",
+                  "events_url": "https://api.github.com/orgs/github/events",
+                  "hooks_url": "https://api.github.com/orgs/github/hooks",
+                  "issues_url": "https://api.github.com/orgs/github/issues",
+                  "members_url": "https://api.github.com/orgs/github/members{/member}",
+                  "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
+                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+                  "description": "A great organization",
+                  "name": "github",
+                  "company": "GitHub",
+                  "blog": "https://github.com/blog",
+                  "location": "San Francisco",
+                  "email": "octocat@github.com",
+                  "has_organization_projects": true,
+                  "has_repository_projects": true,
+                  "public_repos": 2,
+                  "public_gists": 1,
+                  "followers": 20,
+                  "following": 0,
+                  "html_url": "https://github.com/octocat",
+                  "created_at": "2008-01-14T04:33:35Z",
+                  "updated_at": "2017-08-17T12:37:15Z",
+                  "type": "Organization"
+                },
+                "ldap_dn": "uid=asdf,ou=users,dc=github,dc=com"
+              },
+              "schema": {
+                "title": "Full Team",
+                "description": "Groups of organization members that gives permissions on specified repositories.",
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "description": "Unique identifier of the team",
+                    "type": "integer",
+                    "examples": [
+                      42
+                    ]
+                  },
+                  "node_id": {
+                    "type": "string",
+                    "examples": [
+                      "MDQ6VGVhbTE="
+                    ]
+                  },
+                  "url": {
+                    "description": "URL for the team",
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1"
+                    ]
+                  },
+                  "html_url": {
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://github.com/orgs/rails/teams/core"
+                    ]
+                  },
+                  "name": {
+                    "description": "Name of the team",
+                    "type": "string",
+                    "examples": [
+                      "Developers"
+                    ]
+                  },
+                  "slug": {
+                    "type": "string",
+                    "examples": [
+                      "justice-league"
+                    ]
+                  },
+                  "description": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "examples": [
+                      "A great team."
+                    ]
+                  },
+                  "privacy": {
+                    "description": "The level of privacy this team should have",
+                    "type": "string",
+                    "enum": [
+                      "closed",
+                      "secret"
+                    ],
+                    "examples": [
+                      "closed"
+                    ]
+                  },
+                  "permission": {
+                    "description": "Permission that the team will have for its repositories",
+                    "type": "string",
+                    "examples": [
+                      "push"
+                    ]
+                  },
+                  "members_url": {
+                    "type": "string",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1/members{/member}"
+                    ]
+                  },
+                  "repositories_url": {
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1/repos"
+                    ]
+                  },
+                  "parent": {
+                    "anyOf": [
+                      {
+                        "type": "null"
+                      },
+                      {
+                        "title": "Team Simple",
+                        "description": "Groups of organization members that gives permissions on specified repositories.",
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "description": "Unique identifier of the team",
+                            "type": "integer",
+                            "examples": [
+                              1
+                            ]
+                          },
+                          "node_id": {
+                            "type": "string",
+                            "examples": [
+                              "MDQ6VGVhbTE="
+                            ]
+                          },
+                          "url": {
+                            "description": "URL for the team",
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1"
+                            ]
+                          },
+                          "members_url": {
+                            "type": "string",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1/members{/member}"
+                            ]
+                          },
+                          "name": {
+                            "description": "Name of the team",
+                            "type": "string",
+                            "examples": [
+                              "Justice League"
+                            ]
+                          },
+                          "description": {
+                            "description": "Description of the team",
+                            "type": [
+                              "string",
+                              "null"
+                            ],
+                            "examples": [
+                              "A great team."
+                            ]
+                          },
+                          "permission": {
+                            "description": "Permission that the team will have for its repositories",
+                            "type": "string",
+                            "examples": [
+                              "admin"
+                            ]
+                          },
+                          "privacy": {
+                            "description": "The level of privacy this team should have",
+                            "type": "string",
+                            "examples": [
+                              "closed"
+                            ]
+                          },
+                          "html_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://github.com/orgs/rails/teams/core"
+                            ]
+                          },
+                          "repositories_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1/repos"
+                            ]
+                          },
+                          "slug": {
+                            "type": "string",
+                            "examples": [
+                              "justice-league"
+                            ]
+                          },
+                          "ldap_dn": {
+                            "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                            "type": "string",
+                            "examples": [
+                              "uid=example,ou=users,dc=github,dc=com"
+                            ]
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "node_id",
+                          "url",
+                          "members_url",
+                          "name",
+                          "description",
+                          "permission",
+                          "html_url",
+                          "repositories_url",
+                          "slug"
+                        ]
+                      }
+                    ]
+                  },
+                  "members_count": {
+                    "type": "integer",
+                    "examples": [
+                      3
+                    ]
+                  },
+                  "repos_count": {
+                    "type": "integer",
+                    "examples": [
+                      10
+                    ]
+                  },
+                  "created_at": {
+                    "type": "string",
+                    "format": "date-time",
+                    "examples": [
+                      "2017-07-14T16:53:42Z"
+                    ]
+                  },
+                  "updated_at": {
+                    "type": "string",
+                    "format": "date-time",
+                    "examples": [
+                      "2017-08-17T12:37:15Z"
+                    ]
+                  },
+                  "organization": {
+                    "title": "Team Organization",
+                    "description": "Team Organization",
+                    "type": "object",
+                    "properties": {
+                      "login": {
+                        "type": "string",
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "id": {
+                        "type": "integer",
+                        "examples": [
+                          1
+                        ]
+                      },
+                      "node_id": {
+                        "type": "string",
+                        "examples": [
+                          "MDEyOk9yZ2FuaXphdGlvbjE="
+                        ]
+                      },
+                      "url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github"
+                        ]
+                      },
+                      "repos_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github/repos"
+                        ]
+                      },
+                      "events_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github/events"
+                        ]
+                      },
+                      "hooks_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/hooks"
+                        ]
+                      },
+                      "issues_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/issues"
+                        ]
+                      },
+                      "members_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/members{/member}"
+                        ]
+                      },
+                      "public_members_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/public_members{/member}"
+                        ]
+                      },
+                      "avatar_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://github.com/images/error/octocat_happy.gif"
+                        ]
+                      },
+                      "description": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "examples": [
+                          "A great organization"
+                        ]
+                      },
+                      "name": {
+                        "type": "string",
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "company": {
+                        "type": "string",
+                        "examples": [
+                          "GitHub"
+                        ]
+                      },
+                      "blog": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://github.com/blog"
+                        ]
+                      },
+                      "location": {
+                        "type": "string",
+                        "examples": [
+                          "San Francisco"
+                        ]
+                      },
+                      "email": {
+                        "type": "string",
+                        "format": "email",
+                        "examples": [
+                          "octocat@github.com"
+                        ]
+                      },
+                      "twitter_username": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "is_verified": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "has_organization_projects": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "has_repository_projects": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "public_repos": {
+                        "type": "integer",
+                        "examples": [
+                          2
+                        ]
+                      },
+                      "public_gists": {
+                        "type": "integer",
+                        "examples": [
+                          1
+                        ]
+                      },
+                      "followers": {
+                        "type": "integer",
+                        "examples": [
+                          20
+                        ]
+                      },
+                      "following": {
+                        "type": "integer",
+                        "examples": [
+                          0
+                        ]
+                      },
+                      "html_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://github.com/octocat"
+                        ]
+                      },
+                      "created_at": {
+                        "type": "string",
+                        "format": "date-time",
+                        "examples": [
+                          "2008-01-14T04:33:35Z"
+                        ]
+                      },
+                      "type": {
+                        "type": "string",
+                        "examples": [
+                          "Organization"
+                        ]
+                      },
+                      "total_private_repos": {
+                        "type": "integer",
+                        "examples": [
+                          100
+                        ]
+                      },
+                      "owned_private_repos": {
+                        "type": "integer",
+                        "examples": [
+                          100
+                        ]
+                      },
+                      "private_gists": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          81
+                        ]
+                      },
+                      "disk_usage": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          10000
+                        ]
+                      },
+                      "collaborators": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          8
+                        ]
+                      },
+                      "billing_email": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "format": "email",
+                        "examples": [
+                          "org@example.com"
+                        ]
+                      },
+                      "plan": {
+                        "type": "object",
+                        "properties": {
+                          "name": {
+                            "type": "string"
+                          },
+                          "space": {
+                            "type": "integer"
+                          },
+                          "private_repos": {
+                            "type": "integer"
+                          },
+                          "filled_seats": {
+                            "type": "integer"
+                          },
+                          "seats": {
+                            "type": "integer"
+                          }
+                        },
+                        "required": [
+                          "name",
+                          "space",
+                          "private_repos"
+                        ]
+                      },
+                      "default_repository_permission": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "members_can_create_repositories": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "two_factor_requirement_enabled": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_allowed_repository_creation_type": {
+                        "type": "string",
+                        "examples": [
+                          "all"
+                        ]
+                      },
+                      "members_can_create_public_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_private_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_internal_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_public_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_private_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "updated_at": {
+                        "type": "string",
+                        "format": "date-time"
+                      }
+                    },
+                    "required": [
+                      "login",
+                      "url",
+                      "id",
+                      "node_id",
+                      "repos_url",
+                      "events_url",
+                      "hooks_url",
+                      "issues_url",
+                      "members_url",
+                      "public_members_url",
+                      "avatar_url",
+                      "description",
+                      "html_url",
+                      "has_organization_projects",
+                      "has_repository_projects",
+                      "public_repos",
+                      "public_gists",
+                      "followers",
+                      "following",
+                      "type",
+                      "created_at",
+                      "updated_at"
+                    ]
+                  },
+                  "ldap_dn": {
+                    "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                    "type": "string",
+                    "examples": [
+                      "uid=example,ou=users,dc=github,dc=com"
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "node_id",
+                  "url",
+                  "members_url",
+                  "name",
+                  "description",
+                  "permission",
+                  "html_url",
+                  "repositories_url",
+                  "slug",
+                  "created_at",
+                  "updated_at",
+                  "members_count",
+                  "repos_count",
+                  "organization"
+                ]
+              }
+            }
+          },
+          {
+            "key": "default",
+            "request": {
+              "contentType": "application/json",
+              "description": "Example 2: Status Code 201",
               "acceptHeader": "application/vnd.github.v3+json",
               "bodyParameters": {
                 "name": "new team name",
@@ -431814,9 +432489,25 @@
         "previews": [],
         "descriptionHTML": "<p>To edit a team, the authenticated user must either be an organization owner or a team maintainer.</p>\n<p><strong>Note:</strong> You can also specify a team by <code>org_id</code> and <code>team_id</code> using the route <code>PATCH /organizations/{org_id}/team/{team_id}</code>.</p>",
         "statusCodes": [
+          {
+            "httpStatusCode": "200",
+            "description": "<p>Response when the updated information already exists</p>"
+          },
           {
             "httpStatusCode": "201",
             "description": "<p>Created</p>"
+          },
+          {
+            "httpStatusCode": "403",
+            "description": "<p>Forbidden</p>"
+          },
+          {
+            "httpStatusCode": "404",
+            "description": "<p>Resource not found</p>"
+          },
+          {
+            "httpStatusCode": "422",
+            "description": "<p>Validation failed</p>"
           }
         ],
         "subcategory": "teams"
diff --git a/lib/rest/static/decorated/ghes-3.3.json b/lib/rest/static/decorated/ghes-3.3.json
index ed4c4f60d7..8c8ae4ace9 100644
--- a/lib/rest/static/decorated/ghes-3.3.json
+++ b/lib/rest/static/decorated/ghes-3.3.json
@@ -179402,6 +179402,7 @@
             "description": "<p>The base branch and head branch to compare. This parameter expects the format <code>{base}...{head}</code>.</p>",
             "in": "path",
             "required": true,
+            "x-multi-segment": true,
             "schema": {
               "type": "string"
             }
@@ -429172,7 +429173,681 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Example 1: Status Code 200",
+              "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "name": "new team name",
+                "description": "new team description",
+                "privacy": "closed"
+              },
+              "parameters": {
+                "org": "ORG",
+                "team_slug": "TEAM_SLUG"
+              }
+            },
+            "response": {
+              "statusCode": "200",
+              "contentType": "application/json",
+              "description": "<p>Response when the updated information already exists</p>",
+              "example": {
+                "id": 1,
+                "node_id": "MDQ6VGVhbTE=",
+                "url": "https://api.github.com/teams/1",
+                "html_url": "https://github.com/orgs/github/teams/justice-league",
+                "name": "Justice League",
+                "slug": "justice-league",
+                "description": "A great team.",
+                "privacy": "closed",
+                "permission": "admin",
+                "members_url": "https://api.github.com/teams/1/members{/member}",
+                "repositories_url": "https://api.github.com/teams/1/repos",
+                "members_count": 3,
+                "repos_count": 10,
+                "created_at": "2017-07-14T16:53:42Z",
+                "updated_at": "2017-08-17T12:37:15Z",
+                "organization": {
+                  "login": "github",
+                  "id": 1,
+                  "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
+                  "url": "https://api.github.com/orgs/github",
+                  "repos_url": "https://api.github.com/orgs/github/repos",
+                  "events_url": "https://api.github.com/orgs/github/events",
+                  "hooks_url": "https://api.github.com/orgs/github/hooks",
+                  "issues_url": "https://api.github.com/orgs/github/issues",
+                  "members_url": "https://api.github.com/orgs/github/members{/member}",
+                  "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
+                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+                  "description": "A great organization",
+                  "name": "github",
+                  "company": "GitHub",
+                  "blog": "https://github.com/blog",
+                  "location": "San Francisco",
+                  "email": "octocat@github.com",
+                  "has_organization_projects": true,
+                  "has_repository_projects": true,
+                  "public_repos": 2,
+                  "public_gists": 1,
+                  "followers": 20,
+                  "following": 0,
+                  "html_url": "https://github.com/octocat",
+                  "created_at": "2008-01-14T04:33:35Z",
+                  "updated_at": "2017-08-17T12:37:15Z",
+                  "type": "Organization"
+                },
+                "ldap_dn": "uid=asdf,ou=users,dc=github,dc=com"
+              },
+              "schema": {
+                "title": "Full Team",
+                "description": "Groups of organization members that gives permissions on specified repositories.",
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "description": "Unique identifier of the team",
+                    "type": "integer",
+                    "examples": [
+                      42
+                    ]
+                  },
+                  "node_id": {
+                    "type": "string",
+                    "examples": [
+                      "MDQ6VGVhbTE="
+                    ]
+                  },
+                  "url": {
+                    "description": "URL for the team",
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1"
+                    ]
+                  },
+                  "html_url": {
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://github.com/orgs/rails/teams/core"
+                    ]
+                  },
+                  "name": {
+                    "description": "Name of the team",
+                    "type": "string",
+                    "examples": [
+                      "Developers"
+                    ]
+                  },
+                  "slug": {
+                    "type": "string",
+                    "examples": [
+                      "justice-league"
+                    ]
+                  },
+                  "description": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "examples": [
+                      "A great team."
+                    ]
+                  },
+                  "privacy": {
+                    "description": "The level of privacy this team should have",
+                    "type": "string",
+                    "enum": [
+                      "closed",
+                      "secret"
+                    ],
+                    "examples": [
+                      "closed"
+                    ]
+                  },
+                  "permission": {
+                    "description": "Permission that the team will have for its repositories",
+                    "type": "string",
+                    "examples": [
+                      "push"
+                    ]
+                  },
+                  "members_url": {
+                    "type": "string",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1/members{/member}"
+                    ]
+                  },
+                  "repositories_url": {
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1/repos"
+                    ]
+                  },
+                  "parent": {
+                    "anyOf": [
+                      {
+                        "type": "null"
+                      },
+                      {
+                        "title": "Team Simple",
+                        "description": "Groups of organization members that gives permissions on specified repositories.",
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "description": "Unique identifier of the team",
+                            "type": "integer",
+                            "examples": [
+                              1
+                            ]
+                          },
+                          "node_id": {
+                            "type": "string",
+                            "examples": [
+                              "MDQ6VGVhbTE="
+                            ]
+                          },
+                          "url": {
+                            "description": "URL for the team",
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1"
+                            ]
+                          },
+                          "members_url": {
+                            "type": "string",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1/members{/member}"
+                            ]
+                          },
+                          "name": {
+                            "description": "Name of the team",
+                            "type": "string",
+                            "examples": [
+                              "Justice League"
+                            ]
+                          },
+                          "description": {
+                            "description": "Description of the team",
+                            "type": [
+                              "string",
+                              "null"
+                            ],
+                            "examples": [
+                              "A great team."
+                            ]
+                          },
+                          "permission": {
+                            "description": "Permission that the team will have for its repositories",
+                            "type": "string",
+                            "examples": [
+                              "admin"
+                            ]
+                          },
+                          "privacy": {
+                            "description": "The level of privacy this team should have",
+                            "type": "string",
+                            "examples": [
+                              "closed"
+                            ]
+                          },
+                          "html_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://github.com/orgs/rails/teams/core"
+                            ]
+                          },
+                          "repositories_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1/repos"
+                            ]
+                          },
+                          "slug": {
+                            "type": "string",
+                            "examples": [
+                              "justice-league"
+                            ]
+                          },
+                          "ldap_dn": {
+                            "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                            "type": "string",
+                            "examples": [
+                              "uid=example,ou=users,dc=github,dc=com"
+                            ]
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "node_id",
+                          "url",
+                          "members_url",
+                          "name",
+                          "description",
+                          "permission",
+                          "html_url",
+                          "repositories_url",
+                          "slug"
+                        ]
+                      }
+                    ]
+                  },
+                  "members_count": {
+                    "type": "integer",
+                    "examples": [
+                      3
+                    ]
+                  },
+                  "repos_count": {
+                    "type": "integer",
+                    "examples": [
+                      10
+                    ]
+                  },
+                  "created_at": {
+                    "type": "string",
+                    "format": "date-time",
+                    "examples": [
+                      "2017-07-14T16:53:42Z"
+                    ]
+                  },
+                  "updated_at": {
+                    "type": "string",
+                    "format": "date-time",
+                    "examples": [
+                      "2017-08-17T12:37:15Z"
+                    ]
+                  },
+                  "organization": {
+                    "title": "Team Organization",
+                    "description": "Team Organization",
+                    "type": "object",
+                    "properties": {
+                      "login": {
+                        "type": "string",
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "id": {
+                        "type": "integer",
+                        "examples": [
+                          1
+                        ]
+                      },
+                      "node_id": {
+                        "type": "string",
+                        "examples": [
+                          "MDEyOk9yZ2FuaXphdGlvbjE="
+                        ]
+                      },
+                      "url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github"
+                        ]
+                      },
+                      "repos_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github/repos"
+                        ]
+                      },
+                      "events_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github/events"
+                        ]
+                      },
+                      "hooks_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/hooks"
+                        ]
+                      },
+                      "issues_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/issues"
+                        ]
+                      },
+                      "members_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/members{/member}"
+                        ]
+                      },
+                      "public_members_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/public_members{/member}"
+                        ]
+                      },
+                      "avatar_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://github.com/images/error/octocat_happy.gif"
+                        ]
+                      },
+                      "description": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "examples": [
+                          "A great organization"
+                        ]
+                      },
+                      "name": {
+                        "type": "string",
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "company": {
+                        "type": "string",
+                        "examples": [
+                          "GitHub"
+                        ]
+                      },
+                      "blog": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://github.com/blog"
+                        ]
+                      },
+                      "location": {
+                        "type": "string",
+                        "examples": [
+                          "San Francisco"
+                        ]
+                      },
+                      "email": {
+                        "type": "string",
+                        "format": "email",
+                        "examples": [
+                          "octocat@github.com"
+                        ]
+                      },
+                      "twitter_username": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "is_verified": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "has_organization_projects": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "has_repository_projects": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "public_repos": {
+                        "type": "integer",
+                        "examples": [
+                          2
+                        ]
+                      },
+                      "public_gists": {
+                        "type": "integer",
+                        "examples": [
+                          1
+                        ]
+                      },
+                      "followers": {
+                        "type": "integer",
+                        "examples": [
+                          20
+                        ]
+                      },
+                      "following": {
+                        "type": "integer",
+                        "examples": [
+                          0
+                        ]
+                      },
+                      "html_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://github.com/octocat"
+                        ]
+                      },
+                      "created_at": {
+                        "type": "string",
+                        "format": "date-time",
+                        "examples": [
+                          "2008-01-14T04:33:35Z"
+                        ]
+                      },
+                      "type": {
+                        "type": "string",
+                        "examples": [
+                          "Organization"
+                        ]
+                      },
+                      "total_private_repos": {
+                        "type": "integer",
+                        "examples": [
+                          100
+                        ]
+                      },
+                      "owned_private_repos": {
+                        "type": "integer",
+                        "examples": [
+                          100
+                        ]
+                      },
+                      "private_gists": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          81
+                        ]
+                      },
+                      "disk_usage": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          10000
+                        ]
+                      },
+                      "collaborators": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          8
+                        ]
+                      },
+                      "billing_email": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "format": "email",
+                        "examples": [
+                          "org@example.com"
+                        ]
+                      },
+                      "plan": {
+                        "type": "object",
+                        "properties": {
+                          "name": {
+                            "type": "string"
+                          },
+                          "space": {
+                            "type": "integer"
+                          },
+                          "private_repos": {
+                            "type": "integer"
+                          },
+                          "filled_seats": {
+                            "type": "integer"
+                          },
+                          "seats": {
+                            "type": "integer"
+                          }
+                        },
+                        "required": [
+                          "name",
+                          "space",
+                          "private_repos"
+                        ]
+                      },
+                      "default_repository_permission": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "members_can_create_repositories": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "two_factor_requirement_enabled": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_allowed_repository_creation_type": {
+                        "type": "string",
+                        "examples": [
+                          "all"
+                        ]
+                      },
+                      "members_can_create_public_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_private_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_internal_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_public_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_private_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "updated_at": {
+                        "type": "string",
+                        "format": "date-time"
+                      }
+                    },
+                    "required": [
+                      "login",
+                      "url",
+                      "id",
+                      "node_id",
+                      "repos_url",
+                      "events_url",
+                      "hooks_url",
+                      "issues_url",
+                      "members_url",
+                      "public_members_url",
+                      "avatar_url",
+                      "description",
+                      "html_url",
+                      "has_organization_projects",
+                      "has_repository_projects",
+                      "public_repos",
+                      "public_gists",
+                      "followers",
+                      "following",
+                      "type",
+                      "created_at",
+                      "updated_at"
+                    ]
+                  },
+                  "ldap_dn": {
+                    "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                    "type": "string",
+                    "examples": [
+                      "uid=example,ou=users,dc=github,dc=com"
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "node_id",
+                  "url",
+                  "members_url",
+                  "name",
+                  "description",
+                  "permission",
+                  "html_url",
+                  "repositories_url",
+                  "slug",
+                  "created_at",
+                  "updated_at",
+                  "members_count",
+                  "repos_count",
+                  "organization"
+                ]
+              }
+            }
+          },
+          {
+            "key": "default",
+            "request": {
+              "contentType": "application/json",
+              "description": "Example 2: Status Code 201",
               "acceptHeader": "application/vnd.github.v3+json",
               "bodyParameters": {
                 "name": "new team name",
@@ -429846,9 +430521,25 @@
         "previews": [],
         "descriptionHTML": "<p>To edit a team, the authenticated user must either be an organization owner or a team maintainer.</p>\n<p><strong>Note:</strong> You can also specify a team by <code>org_id</code> and <code>team_id</code> using the route <code>PATCH /organizations/{org_id}/team/{team_id}</code>.</p>",
         "statusCodes": [
+          {
+            "httpStatusCode": "200",
+            "description": "<p>Response when the updated information already exists</p>"
+          },
           {
             "httpStatusCode": "201",
             "description": "<p>Created</p>"
+          },
+          {
+            "httpStatusCode": "403",
+            "description": "<p>Forbidden</p>"
+          },
+          {
+            "httpStatusCode": "404",
+            "description": "<p>Resource not found</p>"
+          },
+          {
+            "httpStatusCode": "422",
+            "description": "<p>Validation failed</p>"
           }
         ],
         "subcategory": "teams"
diff --git a/lib/rest/static/decorated/ghes-3.4.json b/lib/rest/static/decorated/ghes-3.4.json
index b6b112f752..80518e3a0a 100644
--- a/lib/rest/static/decorated/ghes-3.4.json
+++ b/lib/rest/static/decorated/ghes-3.4.json
@@ -184812,6 +184812,7 @@
             "description": "<p>The base branch and head branch to compare. This parameter expects the format <code>{base}...{head}</code>.</p>",
             "in": "path",
             "required": true,
+            "x-multi-segment": true,
             "schema": {
               "type": "string"
             }
@@ -451398,7 +451399,690 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Example 1: Status Code 200",
+              "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "name": "new team name",
+                "description": "new team description",
+                "privacy": "closed"
+              },
+              "parameters": {
+                "org": "ORG",
+                "team_slug": "TEAM_SLUG"
+              }
+            },
+            "response": {
+              "statusCode": "200",
+              "contentType": "application/json",
+              "description": "<p>Response when the updated information already exists</p>",
+              "example": {
+                "id": 1,
+                "node_id": "MDQ6VGVhbTE=",
+                "url": "https://api.github.com/teams/1",
+                "html_url": "https://github.com/orgs/github/teams/justice-league",
+                "name": "Justice League",
+                "slug": "justice-league",
+                "description": "A great team.",
+                "privacy": "closed",
+                "permission": "admin",
+                "members_url": "https://api.github.com/teams/1/members{/member}",
+                "repositories_url": "https://api.github.com/teams/1/repos",
+                "members_count": 3,
+                "repos_count": 10,
+                "created_at": "2017-07-14T16:53:42Z",
+                "updated_at": "2017-08-17T12:37:15Z",
+                "organization": {
+                  "login": "github",
+                  "id": 1,
+                  "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
+                  "url": "https://api.github.com/orgs/github",
+                  "repos_url": "https://api.github.com/orgs/github/repos",
+                  "events_url": "https://api.github.com/orgs/github/events",
+                  "hooks_url": "https://api.github.com/orgs/github/hooks",
+                  "issues_url": "https://api.github.com/orgs/github/issues",
+                  "members_url": "https://api.github.com/orgs/github/members{/member}",
+                  "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
+                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+                  "description": "A great organization",
+                  "name": "github",
+                  "company": "GitHub",
+                  "blog": "https://github.com/blog",
+                  "location": "San Francisco",
+                  "email": "octocat@github.com",
+                  "has_organization_projects": true,
+                  "has_repository_projects": true,
+                  "public_repos": 2,
+                  "public_gists": 1,
+                  "followers": 20,
+                  "following": 0,
+                  "html_url": "https://github.com/octocat",
+                  "created_at": "2008-01-14T04:33:35Z",
+                  "updated_at": "2017-08-17T12:37:15Z",
+                  "type": "Organization"
+                },
+                "ldap_dn": "uid=asdf,ou=users,dc=github,dc=com"
+              },
+              "schema": {
+                "title": "Full Team",
+                "description": "Groups of organization members that gives permissions on specified repositories.",
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "description": "Unique identifier of the team",
+                    "type": "integer",
+                    "examples": [
+                      42
+                    ]
+                  },
+                  "node_id": {
+                    "type": "string",
+                    "examples": [
+                      "MDQ6VGVhbTE="
+                    ]
+                  },
+                  "url": {
+                    "description": "URL for the team",
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1"
+                    ]
+                  },
+                  "html_url": {
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://github.com/orgs/rails/teams/core"
+                    ]
+                  },
+                  "name": {
+                    "description": "Name of the team",
+                    "type": "string",
+                    "examples": [
+                      "Developers"
+                    ]
+                  },
+                  "slug": {
+                    "type": "string",
+                    "examples": [
+                      "justice-league"
+                    ]
+                  },
+                  "description": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "examples": [
+                      "A great team."
+                    ]
+                  },
+                  "privacy": {
+                    "description": "The level of privacy this team should have",
+                    "type": "string",
+                    "enum": [
+                      "closed",
+                      "secret"
+                    ],
+                    "examples": [
+                      "closed"
+                    ]
+                  },
+                  "permission": {
+                    "description": "Permission that the team will have for its repositories",
+                    "type": "string",
+                    "examples": [
+                      "push"
+                    ]
+                  },
+                  "members_url": {
+                    "type": "string",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1/members{/member}"
+                    ]
+                  },
+                  "repositories_url": {
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1/repos"
+                    ]
+                  },
+                  "parent": {
+                    "anyOf": [
+                      {
+                        "type": "null"
+                      },
+                      {
+                        "title": "Team Simple",
+                        "description": "Groups of organization members that gives permissions on specified repositories.",
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "description": "Unique identifier of the team",
+                            "type": "integer",
+                            "examples": [
+                              1
+                            ]
+                          },
+                          "node_id": {
+                            "type": "string",
+                            "examples": [
+                              "MDQ6VGVhbTE="
+                            ]
+                          },
+                          "url": {
+                            "description": "URL for the team",
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1"
+                            ]
+                          },
+                          "members_url": {
+                            "type": "string",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1/members{/member}"
+                            ]
+                          },
+                          "name": {
+                            "description": "Name of the team",
+                            "type": "string",
+                            "examples": [
+                              "Justice League"
+                            ]
+                          },
+                          "description": {
+                            "description": "Description of the team",
+                            "type": [
+                              "string",
+                              "null"
+                            ],
+                            "examples": [
+                              "A great team."
+                            ]
+                          },
+                          "permission": {
+                            "description": "Permission that the team will have for its repositories",
+                            "type": "string",
+                            "examples": [
+                              "admin"
+                            ]
+                          },
+                          "privacy": {
+                            "description": "The level of privacy this team should have",
+                            "type": "string",
+                            "examples": [
+                              "closed"
+                            ]
+                          },
+                          "html_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://github.com/orgs/rails/teams/core"
+                            ]
+                          },
+                          "repositories_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1/repos"
+                            ]
+                          },
+                          "slug": {
+                            "type": "string",
+                            "examples": [
+                              "justice-league"
+                            ]
+                          },
+                          "ldap_dn": {
+                            "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                            "type": "string",
+                            "examples": [
+                              "uid=example,ou=users,dc=github,dc=com"
+                            ]
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "node_id",
+                          "url",
+                          "members_url",
+                          "name",
+                          "description",
+                          "permission",
+                          "html_url",
+                          "repositories_url",
+                          "slug"
+                        ]
+                      }
+                    ]
+                  },
+                  "members_count": {
+                    "type": "integer",
+                    "examples": [
+                      3
+                    ]
+                  },
+                  "repos_count": {
+                    "type": "integer",
+                    "examples": [
+                      10
+                    ]
+                  },
+                  "created_at": {
+                    "type": "string",
+                    "format": "date-time",
+                    "examples": [
+                      "2017-07-14T16:53:42Z"
+                    ]
+                  },
+                  "updated_at": {
+                    "type": "string",
+                    "format": "date-time",
+                    "examples": [
+                      "2017-08-17T12:37:15Z"
+                    ]
+                  },
+                  "organization": {
+                    "title": "Team Organization",
+                    "description": "Team Organization",
+                    "type": "object",
+                    "properties": {
+                      "login": {
+                        "type": "string",
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "id": {
+                        "type": "integer",
+                        "examples": [
+                          1
+                        ]
+                      },
+                      "node_id": {
+                        "type": "string",
+                        "examples": [
+                          "MDEyOk9yZ2FuaXphdGlvbjE="
+                        ]
+                      },
+                      "url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github"
+                        ]
+                      },
+                      "repos_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github/repos"
+                        ]
+                      },
+                      "events_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github/events"
+                        ]
+                      },
+                      "hooks_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/hooks"
+                        ]
+                      },
+                      "issues_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/issues"
+                        ]
+                      },
+                      "members_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/members{/member}"
+                        ]
+                      },
+                      "public_members_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/public_members{/member}"
+                        ]
+                      },
+                      "avatar_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://github.com/images/error/octocat_happy.gif"
+                        ]
+                      },
+                      "description": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "examples": [
+                          "A great organization"
+                        ]
+                      },
+                      "name": {
+                        "type": "string",
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "company": {
+                        "type": "string",
+                        "examples": [
+                          "GitHub"
+                        ]
+                      },
+                      "blog": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://github.com/blog"
+                        ]
+                      },
+                      "location": {
+                        "type": "string",
+                        "examples": [
+                          "San Francisco"
+                        ]
+                      },
+                      "email": {
+                        "type": "string",
+                        "format": "email",
+                        "examples": [
+                          "octocat@github.com"
+                        ]
+                      },
+                      "twitter_username": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "is_verified": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "has_organization_projects": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "has_repository_projects": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "public_repos": {
+                        "type": "integer",
+                        "examples": [
+                          2
+                        ]
+                      },
+                      "public_gists": {
+                        "type": "integer",
+                        "examples": [
+                          1
+                        ]
+                      },
+                      "followers": {
+                        "type": "integer",
+                        "examples": [
+                          20
+                        ]
+                      },
+                      "following": {
+                        "type": "integer",
+                        "examples": [
+                          0
+                        ]
+                      },
+                      "html_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://github.com/octocat"
+                        ]
+                      },
+                      "created_at": {
+                        "type": "string",
+                        "format": "date-time",
+                        "examples": [
+                          "2008-01-14T04:33:35Z"
+                        ]
+                      },
+                      "type": {
+                        "type": "string",
+                        "examples": [
+                          "Organization"
+                        ]
+                      },
+                      "total_private_repos": {
+                        "type": "integer",
+                        "examples": [
+                          100
+                        ]
+                      },
+                      "owned_private_repos": {
+                        "type": "integer",
+                        "examples": [
+                          100
+                        ]
+                      },
+                      "private_gists": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          81
+                        ]
+                      },
+                      "disk_usage": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          10000
+                        ]
+                      },
+                      "collaborators": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          8
+                        ]
+                      },
+                      "billing_email": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "format": "email",
+                        "examples": [
+                          "org@example.com"
+                        ]
+                      },
+                      "plan": {
+                        "type": "object",
+                        "properties": {
+                          "name": {
+                            "type": "string"
+                          },
+                          "space": {
+                            "type": "integer"
+                          },
+                          "private_repos": {
+                            "type": "integer"
+                          },
+                          "filled_seats": {
+                            "type": "integer"
+                          },
+                          "seats": {
+                            "type": "integer"
+                          }
+                        },
+                        "required": [
+                          "name",
+                          "space",
+                          "private_repos"
+                        ]
+                      },
+                      "default_repository_permission": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "members_can_create_repositories": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "two_factor_requirement_enabled": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_allowed_repository_creation_type": {
+                        "type": "string",
+                        "examples": [
+                          "all"
+                        ]
+                      },
+                      "members_can_create_public_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_private_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_internal_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_public_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_private_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_fork_private_repositories": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          false
+                        ]
+                      },
+                      "updated_at": {
+                        "type": "string",
+                        "format": "date-time"
+                      }
+                    },
+                    "required": [
+                      "login",
+                      "url",
+                      "id",
+                      "node_id",
+                      "repos_url",
+                      "events_url",
+                      "hooks_url",
+                      "issues_url",
+                      "members_url",
+                      "public_members_url",
+                      "avatar_url",
+                      "description",
+                      "html_url",
+                      "has_organization_projects",
+                      "has_repository_projects",
+                      "public_repos",
+                      "public_gists",
+                      "followers",
+                      "following",
+                      "type",
+                      "created_at",
+                      "updated_at"
+                    ]
+                  },
+                  "ldap_dn": {
+                    "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                    "type": "string",
+                    "examples": [
+                      "uid=example,ou=users,dc=github,dc=com"
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "node_id",
+                  "url",
+                  "members_url",
+                  "name",
+                  "description",
+                  "permission",
+                  "html_url",
+                  "repositories_url",
+                  "slug",
+                  "created_at",
+                  "updated_at",
+                  "members_count",
+                  "repos_count",
+                  "organization"
+                ]
+              }
+            }
+          },
+          {
+            "key": "default",
+            "request": {
+              "contentType": "application/json",
+              "description": "Example 2: Status Code 201",
               "acceptHeader": "application/vnd.github.v3+json",
               "bodyParameters": {
                 "name": "new team name",
@@ -452081,9 +452765,25 @@
         "previews": [],
         "descriptionHTML": "<p>To edit a team, the authenticated user must either be an organization owner or a team maintainer.</p>\n<p><strong>Note:</strong> You can also specify a team by <code>org_id</code> and <code>team_id</code> using the route <code>PATCH /organizations/{org_id}/team/{team_id}</code>.</p>",
         "statusCodes": [
+          {
+            "httpStatusCode": "200",
+            "description": "<p>Response when the updated information already exists</p>"
+          },
           {
             "httpStatusCode": "201",
             "description": "<p>Created</p>"
+          },
+          {
+            "httpStatusCode": "403",
+            "description": "<p>Forbidden</p>"
+          },
+          {
+            "httpStatusCode": "404",
+            "description": "<p>Resource not found</p>"
+          },
+          {
+            "httpStatusCode": "422",
+            "description": "<p>Validation failed</p>"
           }
         ],
         "subcategory": "teams"
diff --git a/lib/rest/static/decorated/ghes-3.5.json b/lib/rest/static/decorated/ghes-3.5.json
index 44075f610f..6c1dae9c51 100644
--- a/lib/rest/static/decorated/ghes-3.5.json
+++ b/lib/rest/static/decorated/ghes-3.5.json
@@ -194713,6 +194713,7 @@
             "description": "<p>The base branch and head branch to compare. This parameter expects the format <code>{base}...{head}</code>.</p>",
             "in": "path",
             "required": true,
+            "x-multi-segment": true,
             "schema": {
               "type": "string"
             }
@@ -461795,7 +461796,690 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Example 1: Status Code 200",
+              "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "name": "new team name",
+                "description": "new team description",
+                "privacy": "closed"
+              },
+              "parameters": {
+                "org": "ORG",
+                "team_slug": "TEAM_SLUG"
+              }
+            },
+            "response": {
+              "statusCode": "200",
+              "contentType": "application/json",
+              "description": "<p>Response when the updated information already exists</p>",
+              "example": {
+                "id": 1,
+                "node_id": "MDQ6VGVhbTE=",
+                "url": "https://api.github.com/teams/1",
+                "html_url": "https://github.com/orgs/github/teams/justice-league",
+                "name": "Justice League",
+                "slug": "justice-league",
+                "description": "A great team.",
+                "privacy": "closed",
+                "permission": "admin",
+                "members_url": "https://api.github.com/teams/1/members{/member}",
+                "repositories_url": "https://api.github.com/teams/1/repos",
+                "members_count": 3,
+                "repos_count": 10,
+                "created_at": "2017-07-14T16:53:42Z",
+                "updated_at": "2017-08-17T12:37:15Z",
+                "organization": {
+                  "login": "github",
+                  "id": 1,
+                  "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
+                  "url": "https://api.github.com/orgs/github",
+                  "repos_url": "https://api.github.com/orgs/github/repos",
+                  "events_url": "https://api.github.com/orgs/github/events",
+                  "hooks_url": "https://api.github.com/orgs/github/hooks",
+                  "issues_url": "https://api.github.com/orgs/github/issues",
+                  "members_url": "https://api.github.com/orgs/github/members{/member}",
+                  "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
+                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+                  "description": "A great organization",
+                  "name": "github",
+                  "company": "GitHub",
+                  "blog": "https://github.com/blog",
+                  "location": "San Francisco",
+                  "email": "octocat@github.com",
+                  "has_organization_projects": true,
+                  "has_repository_projects": true,
+                  "public_repos": 2,
+                  "public_gists": 1,
+                  "followers": 20,
+                  "following": 0,
+                  "html_url": "https://github.com/octocat",
+                  "created_at": "2008-01-14T04:33:35Z",
+                  "updated_at": "2017-08-17T12:37:15Z",
+                  "type": "Organization"
+                },
+                "ldap_dn": "uid=asdf,ou=users,dc=github,dc=com"
+              },
+              "schema": {
+                "title": "Full Team",
+                "description": "Groups of organization members that gives permissions on specified repositories.",
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "description": "Unique identifier of the team",
+                    "type": "integer",
+                    "examples": [
+                      42
+                    ]
+                  },
+                  "node_id": {
+                    "type": "string",
+                    "examples": [
+                      "MDQ6VGVhbTE="
+                    ]
+                  },
+                  "url": {
+                    "description": "URL for the team",
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1"
+                    ]
+                  },
+                  "html_url": {
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://github.com/orgs/rails/teams/core"
+                    ]
+                  },
+                  "name": {
+                    "description": "Name of the team",
+                    "type": "string",
+                    "examples": [
+                      "Developers"
+                    ]
+                  },
+                  "slug": {
+                    "type": "string",
+                    "examples": [
+                      "justice-league"
+                    ]
+                  },
+                  "description": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "examples": [
+                      "A great team."
+                    ]
+                  },
+                  "privacy": {
+                    "description": "The level of privacy this team should have",
+                    "type": "string",
+                    "enum": [
+                      "closed",
+                      "secret"
+                    ],
+                    "examples": [
+                      "closed"
+                    ]
+                  },
+                  "permission": {
+                    "description": "Permission that the team will have for its repositories",
+                    "type": "string",
+                    "examples": [
+                      "push"
+                    ]
+                  },
+                  "members_url": {
+                    "type": "string",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1/members{/member}"
+                    ]
+                  },
+                  "repositories_url": {
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1/repos"
+                    ]
+                  },
+                  "parent": {
+                    "anyOf": [
+                      {
+                        "type": "null"
+                      },
+                      {
+                        "title": "Team Simple",
+                        "description": "Groups of organization members that gives permissions on specified repositories.",
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "description": "Unique identifier of the team",
+                            "type": "integer",
+                            "examples": [
+                              1
+                            ]
+                          },
+                          "node_id": {
+                            "type": "string",
+                            "examples": [
+                              "MDQ6VGVhbTE="
+                            ]
+                          },
+                          "url": {
+                            "description": "URL for the team",
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1"
+                            ]
+                          },
+                          "members_url": {
+                            "type": "string",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1/members{/member}"
+                            ]
+                          },
+                          "name": {
+                            "description": "Name of the team",
+                            "type": "string",
+                            "examples": [
+                              "Justice League"
+                            ]
+                          },
+                          "description": {
+                            "description": "Description of the team",
+                            "type": [
+                              "string",
+                              "null"
+                            ],
+                            "examples": [
+                              "A great team."
+                            ]
+                          },
+                          "permission": {
+                            "description": "Permission that the team will have for its repositories",
+                            "type": "string",
+                            "examples": [
+                              "admin"
+                            ]
+                          },
+                          "privacy": {
+                            "description": "The level of privacy this team should have",
+                            "type": "string",
+                            "examples": [
+                              "closed"
+                            ]
+                          },
+                          "html_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://github.com/orgs/rails/teams/core"
+                            ]
+                          },
+                          "repositories_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1/repos"
+                            ]
+                          },
+                          "slug": {
+                            "type": "string",
+                            "examples": [
+                              "justice-league"
+                            ]
+                          },
+                          "ldap_dn": {
+                            "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                            "type": "string",
+                            "examples": [
+                              "uid=example,ou=users,dc=github,dc=com"
+                            ]
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "node_id",
+                          "url",
+                          "members_url",
+                          "name",
+                          "description",
+                          "permission",
+                          "html_url",
+                          "repositories_url",
+                          "slug"
+                        ]
+                      }
+                    ]
+                  },
+                  "members_count": {
+                    "type": "integer",
+                    "examples": [
+                      3
+                    ]
+                  },
+                  "repos_count": {
+                    "type": "integer",
+                    "examples": [
+                      10
+                    ]
+                  },
+                  "created_at": {
+                    "type": "string",
+                    "format": "date-time",
+                    "examples": [
+                      "2017-07-14T16:53:42Z"
+                    ]
+                  },
+                  "updated_at": {
+                    "type": "string",
+                    "format": "date-time",
+                    "examples": [
+                      "2017-08-17T12:37:15Z"
+                    ]
+                  },
+                  "organization": {
+                    "title": "Team Organization",
+                    "description": "Team Organization",
+                    "type": "object",
+                    "properties": {
+                      "login": {
+                        "type": "string",
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "id": {
+                        "type": "integer",
+                        "examples": [
+                          1
+                        ]
+                      },
+                      "node_id": {
+                        "type": "string",
+                        "examples": [
+                          "MDEyOk9yZ2FuaXphdGlvbjE="
+                        ]
+                      },
+                      "url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github"
+                        ]
+                      },
+                      "repos_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github/repos"
+                        ]
+                      },
+                      "events_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github/events"
+                        ]
+                      },
+                      "hooks_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/hooks"
+                        ]
+                      },
+                      "issues_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/issues"
+                        ]
+                      },
+                      "members_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/members{/member}"
+                        ]
+                      },
+                      "public_members_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/public_members{/member}"
+                        ]
+                      },
+                      "avatar_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://github.com/images/error/octocat_happy.gif"
+                        ]
+                      },
+                      "description": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "examples": [
+                          "A great organization"
+                        ]
+                      },
+                      "name": {
+                        "type": "string",
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "company": {
+                        "type": "string",
+                        "examples": [
+                          "GitHub"
+                        ]
+                      },
+                      "blog": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://github.com/blog"
+                        ]
+                      },
+                      "location": {
+                        "type": "string",
+                        "examples": [
+                          "San Francisco"
+                        ]
+                      },
+                      "email": {
+                        "type": "string",
+                        "format": "email",
+                        "examples": [
+                          "octocat@github.com"
+                        ]
+                      },
+                      "twitter_username": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "is_verified": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "has_organization_projects": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "has_repository_projects": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "public_repos": {
+                        "type": "integer",
+                        "examples": [
+                          2
+                        ]
+                      },
+                      "public_gists": {
+                        "type": "integer",
+                        "examples": [
+                          1
+                        ]
+                      },
+                      "followers": {
+                        "type": "integer",
+                        "examples": [
+                          20
+                        ]
+                      },
+                      "following": {
+                        "type": "integer",
+                        "examples": [
+                          0
+                        ]
+                      },
+                      "html_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://github.com/octocat"
+                        ]
+                      },
+                      "created_at": {
+                        "type": "string",
+                        "format": "date-time",
+                        "examples": [
+                          "2008-01-14T04:33:35Z"
+                        ]
+                      },
+                      "type": {
+                        "type": "string",
+                        "examples": [
+                          "Organization"
+                        ]
+                      },
+                      "total_private_repos": {
+                        "type": "integer",
+                        "examples": [
+                          100
+                        ]
+                      },
+                      "owned_private_repos": {
+                        "type": "integer",
+                        "examples": [
+                          100
+                        ]
+                      },
+                      "private_gists": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          81
+                        ]
+                      },
+                      "disk_usage": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          10000
+                        ]
+                      },
+                      "collaborators": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          8
+                        ]
+                      },
+                      "billing_email": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "format": "email",
+                        "examples": [
+                          "org@example.com"
+                        ]
+                      },
+                      "plan": {
+                        "type": "object",
+                        "properties": {
+                          "name": {
+                            "type": "string"
+                          },
+                          "space": {
+                            "type": "integer"
+                          },
+                          "private_repos": {
+                            "type": "integer"
+                          },
+                          "filled_seats": {
+                            "type": "integer"
+                          },
+                          "seats": {
+                            "type": "integer"
+                          }
+                        },
+                        "required": [
+                          "name",
+                          "space",
+                          "private_repos"
+                        ]
+                      },
+                      "default_repository_permission": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "members_can_create_repositories": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "two_factor_requirement_enabled": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_allowed_repository_creation_type": {
+                        "type": "string",
+                        "examples": [
+                          "all"
+                        ]
+                      },
+                      "members_can_create_public_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_private_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_internal_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_public_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_private_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_fork_private_repositories": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          false
+                        ]
+                      },
+                      "updated_at": {
+                        "type": "string",
+                        "format": "date-time"
+                      }
+                    },
+                    "required": [
+                      "login",
+                      "url",
+                      "id",
+                      "node_id",
+                      "repos_url",
+                      "events_url",
+                      "hooks_url",
+                      "issues_url",
+                      "members_url",
+                      "public_members_url",
+                      "avatar_url",
+                      "description",
+                      "html_url",
+                      "has_organization_projects",
+                      "has_repository_projects",
+                      "public_repos",
+                      "public_gists",
+                      "followers",
+                      "following",
+                      "type",
+                      "created_at",
+                      "updated_at"
+                    ]
+                  },
+                  "ldap_dn": {
+                    "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                    "type": "string",
+                    "examples": [
+                      "uid=example,ou=users,dc=github,dc=com"
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "node_id",
+                  "url",
+                  "members_url",
+                  "name",
+                  "description",
+                  "permission",
+                  "html_url",
+                  "repositories_url",
+                  "slug",
+                  "created_at",
+                  "updated_at",
+                  "members_count",
+                  "repos_count",
+                  "organization"
+                ]
+              }
+            }
+          },
+          {
+            "key": "default",
+            "request": {
+              "contentType": "application/json",
+              "description": "Example 2: Status Code 201",
               "acceptHeader": "application/vnd.github.v3+json",
               "bodyParameters": {
                 "name": "new team name",
@@ -462478,9 +463162,25 @@
         "previews": [],
         "descriptionHTML": "<p>To edit a team, the authenticated user must either be an organization owner or a team maintainer.</p>\n<p><strong>Note:</strong> You can also specify a team by <code>org_id</code> and <code>team_id</code> using the route <code>PATCH /organizations/{org_id}/team/{team_id}</code>.</p>",
         "statusCodes": [
+          {
+            "httpStatusCode": "200",
+            "description": "<p>Response when the updated information already exists</p>"
+          },
           {
             "httpStatusCode": "201",
             "description": "<p>Created</p>"
+          },
+          {
+            "httpStatusCode": "403",
+            "description": "<p>Forbidden</p>"
+          },
+          {
+            "httpStatusCode": "404",
+            "description": "<p>Resource not found</p>"
+          },
+          {
+            "httpStatusCode": "422",
+            "description": "<p>Validation failed</p>"
           }
         ],
         "subcategory": "teams"
diff --git a/lib/rest/static/decorated/ghes-3.6.json b/lib/rest/static/decorated/ghes-3.6.json
index e3ecd45d9d..74f4bfeb37 100644
--- a/lib/rest/static/decorated/ghes-3.6.json
+++ b/lib/rest/static/decorated/ghes-3.6.json
@@ -199461,6 +199461,7 @@
             "description": "<p>The base branch and head branch to compare. This parameter expects the format <code>{base}...{head}</code>.</p>",
             "in": "path",
             "required": true,
+            "x-multi-segment": true,
             "schema": {
               "type": "string"
             }
@@ -472024,7 +472025,696 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Example 1: Status Code 200",
+              "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "name": "new team name",
+                "description": "new team description",
+                "privacy": "closed"
+              },
+              "parameters": {
+                "org": "ORG",
+                "team_slug": "TEAM_SLUG"
+              }
+            },
+            "response": {
+              "statusCode": "200",
+              "contentType": "application/json",
+              "description": "<p>Response when the updated information already exists</p>",
+              "example": {
+                "id": 1,
+                "node_id": "MDQ6VGVhbTE=",
+                "url": "https://api.github.com/teams/1",
+                "html_url": "https://github.com/orgs/github/teams/justice-league",
+                "name": "Justice League",
+                "slug": "justice-league",
+                "description": "A great team.",
+                "privacy": "closed",
+                "permission": "admin",
+                "members_url": "https://api.github.com/teams/1/members{/member}",
+                "repositories_url": "https://api.github.com/teams/1/repos",
+                "members_count": 3,
+                "repos_count": 10,
+                "created_at": "2017-07-14T16:53:42Z",
+                "updated_at": "2017-08-17T12:37:15Z",
+                "organization": {
+                  "login": "github",
+                  "id": 1,
+                  "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
+                  "url": "https://api.github.com/orgs/github",
+                  "repos_url": "https://api.github.com/orgs/github/repos",
+                  "events_url": "https://api.github.com/orgs/github/events",
+                  "hooks_url": "https://api.github.com/orgs/github/hooks",
+                  "issues_url": "https://api.github.com/orgs/github/issues",
+                  "members_url": "https://api.github.com/orgs/github/members{/member}",
+                  "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
+                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+                  "description": "A great organization",
+                  "name": "github",
+                  "company": "GitHub",
+                  "blog": "https://github.com/blog",
+                  "location": "San Francisco",
+                  "email": "octocat@github.com",
+                  "has_organization_projects": true,
+                  "has_repository_projects": true,
+                  "public_repos": 2,
+                  "public_gists": 1,
+                  "followers": 20,
+                  "following": 0,
+                  "html_url": "https://github.com/octocat",
+                  "created_at": "2008-01-14T04:33:35Z",
+                  "updated_at": "2017-08-17T12:37:15Z",
+                  "type": "Organization"
+                },
+                "ldap_dn": "uid=asdf,ou=users,dc=github,dc=com"
+              },
+              "schema": {
+                "title": "Full Team",
+                "description": "Groups of organization members that gives permissions on specified repositories.",
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "description": "Unique identifier of the team",
+                    "type": "integer",
+                    "examples": [
+                      42
+                    ]
+                  },
+                  "node_id": {
+                    "type": "string",
+                    "examples": [
+                      "MDQ6VGVhbTE="
+                    ]
+                  },
+                  "url": {
+                    "description": "URL for the team",
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1"
+                    ]
+                  },
+                  "html_url": {
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://github.com/orgs/rails/teams/core"
+                    ]
+                  },
+                  "name": {
+                    "description": "Name of the team",
+                    "type": "string",
+                    "examples": [
+                      "Developers"
+                    ]
+                  },
+                  "slug": {
+                    "type": "string",
+                    "examples": [
+                      "justice-league"
+                    ]
+                  },
+                  "description": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "examples": [
+                      "A great team."
+                    ]
+                  },
+                  "privacy": {
+                    "description": "The level of privacy this team should have",
+                    "type": "string",
+                    "enum": [
+                      "closed",
+                      "secret"
+                    ],
+                    "examples": [
+                      "closed"
+                    ]
+                  },
+                  "permission": {
+                    "description": "Permission that the team will have for its repositories",
+                    "type": "string",
+                    "examples": [
+                      "push"
+                    ]
+                  },
+                  "members_url": {
+                    "type": "string",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1/members{/member}"
+                    ]
+                  },
+                  "repositories_url": {
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1/repos"
+                    ]
+                  },
+                  "parent": {
+                    "anyOf": [
+                      {
+                        "type": "null"
+                      },
+                      {
+                        "title": "Team Simple",
+                        "description": "Groups of organization members that gives permissions on specified repositories.",
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "description": "Unique identifier of the team",
+                            "type": "integer",
+                            "examples": [
+                              1
+                            ]
+                          },
+                          "node_id": {
+                            "type": "string",
+                            "examples": [
+                              "MDQ6VGVhbTE="
+                            ]
+                          },
+                          "url": {
+                            "description": "URL for the team",
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1"
+                            ]
+                          },
+                          "members_url": {
+                            "type": "string",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1/members{/member}"
+                            ]
+                          },
+                          "name": {
+                            "description": "Name of the team",
+                            "type": "string",
+                            "examples": [
+                              "Justice League"
+                            ]
+                          },
+                          "description": {
+                            "description": "Description of the team",
+                            "type": [
+                              "string",
+                              "null"
+                            ],
+                            "examples": [
+                              "A great team."
+                            ]
+                          },
+                          "permission": {
+                            "description": "Permission that the team will have for its repositories",
+                            "type": "string",
+                            "examples": [
+                              "admin"
+                            ]
+                          },
+                          "privacy": {
+                            "description": "The level of privacy this team should have",
+                            "type": "string",
+                            "examples": [
+                              "closed"
+                            ]
+                          },
+                          "html_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://github.com/orgs/rails/teams/core"
+                            ]
+                          },
+                          "repositories_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1/repos"
+                            ]
+                          },
+                          "slug": {
+                            "type": "string",
+                            "examples": [
+                              "justice-league"
+                            ]
+                          },
+                          "ldap_dn": {
+                            "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                            "type": "string",
+                            "examples": [
+                              "uid=example,ou=users,dc=github,dc=com"
+                            ]
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "node_id",
+                          "url",
+                          "members_url",
+                          "name",
+                          "description",
+                          "permission",
+                          "html_url",
+                          "repositories_url",
+                          "slug"
+                        ]
+                      }
+                    ]
+                  },
+                  "members_count": {
+                    "type": "integer",
+                    "examples": [
+                      3
+                    ]
+                  },
+                  "repos_count": {
+                    "type": "integer",
+                    "examples": [
+                      10
+                    ]
+                  },
+                  "created_at": {
+                    "type": "string",
+                    "format": "date-time",
+                    "examples": [
+                      "2017-07-14T16:53:42Z"
+                    ]
+                  },
+                  "updated_at": {
+                    "type": "string",
+                    "format": "date-time",
+                    "examples": [
+                      "2017-08-17T12:37:15Z"
+                    ]
+                  },
+                  "organization": {
+                    "title": "Team Organization",
+                    "description": "Team Organization",
+                    "type": "object",
+                    "properties": {
+                      "login": {
+                        "type": "string",
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "id": {
+                        "type": "integer",
+                        "examples": [
+                          1
+                        ]
+                      },
+                      "node_id": {
+                        "type": "string",
+                        "examples": [
+                          "MDEyOk9yZ2FuaXphdGlvbjE="
+                        ]
+                      },
+                      "url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github"
+                        ]
+                      },
+                      "repos_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github/repos"
+                        ]
+                      },
+                      "events_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github/events"
+                        ]
+                      },
+                      "hooks_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/hooks"
+                        ]
+                      },
+                      "issues_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/issues"
+                        ]
+                      },
+                      "members_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/members{/member}"
+                        ]
+                      },
+                      "public_members_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/public_members{/member}"
+                        ]
+                      },
+                      "avatar_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://github.com/images/error/octocat_happy.gif"
+                        ]
+                      },
+                      "description": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "examples": [
+                          "A great organization"
+                        ]
+                      },
+                      "name": {
+                        "type": "string",
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "company": {
+                        "type": "string",
+                        "examples": [
+                          "GitHub"
+                        ]
+                      },
+                      "blog": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://github.com/blog"
+                        ]
+                      },
+                      "location": {
+                        "type": "string",
+                        "examples": [
+                          "San Francisco"
+                        ]
+                      },
+                      "email": {
+                        "type": "string",
+                        "format": "email",
+                        "examples": [
+                          "octocat@github.com"
+                        ]
+                      },
+                      "twitter_username": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "is_verified": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "has_organization_projects": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "has_repository_projects": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "public_repos": {
+                        "type": "integer",
+                        "examples": [
+                          2
+                        ]
+                      },
+                      "public_gists": {
+                        "type": "integer",
+                        "examples": [
+                          1
+                        ]
+                      },
+                      "followers": {
+                        "type": "integer",
+                        "examples": [
+                          20
+                        ]
+                      },
+                      "following": {
+                        "type": "integer",
+                        "examples": [
+                          0
+                        ]
+                      },
+                      "html_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://github.com/octocat"
+                        ]
+                      },
+                      "created_at": {
+                        "type": "string",
+                        "format": "date-time",
+                        "examples": [
+                          "2008-01-14T04:33:35Z"
+                        ]
+                      },
+                      "type": {
+                        "type": "string",
+                        "examples": [
+                          "Organization"
+                        ]
+                      },
+                      "total_private_repos": {
+                        "type": "integer",
+                        "examples": [
+                          100
+                        ]
+                      },
+                      "owned_private_repos": {
+                        "type": "integer",
+                        "examples": [
+                          100
+                        ]
+                      },
+                      "private_gists": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          81
+                        ]
+                      },
+                      "disk_usage": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          10000
+                        ]
+                      },
+                      "collaborators": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          8
+                        ]
+                      },
+                      "billing_email": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "format": "email",
+                        "examples": [
+                          "org@example.com"
+                        ]
+                      },
+                      "plan": {
+                        "type": "object",
+                        "properties": {
+                          "name": {
+                            "type": "string"
+                          },
+                          "space": {
+                            "type": "integer"
+                          },
+                          "private_repos": {
+                            "type": "integer"
+                          },
+                          "filled_seats": {
+                            "type": "integer"
+                          },
+                          "seats": {
+                            "type": "integer"
+                          }
+                        },
+                        "required": [
+                          "name",
+                          "space",
+                          "private_repos"
+                        ]
+                      },
+                      "default_repository_permission": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "members_can_create_repositories": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "two_factor_requirement_enabled": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_allowed_repository_creation_type": {
+                        "type": "string",
+                        "examples": [
+                          "all"
+                        ]
+                      },
+                      "members_can_create_public_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_private_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_internal_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_public_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_private_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_fork_private_repositories": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          false
+                        ]
+                      },
+                      "web_commit_signoff_required": {
+                        "type": "boolean",
+                        "examples": [
+                          false
+                        ]
+                      },
+                      "updated_at": {
+                        "type": "string",
+                        "format": "date-time"
+                      }
+                    },
+                    "required": [
+                      "login",
+                      "url",
+                      "id",
+                      "node_id",
+                      "repos_url",
+                      "events_url",
+                      "hooks_url",
+                      "issues_url",
+                      "members_url",
+                      "public_members_url",
+                      "avatar_url",
+                      "description",
+                      "html_url",
+                      "has_organization_projects",
+                      "has_repository_projects",
+                      "public_repos",
+                      "public_gists",
+                      "followers",
+                      "following",
+                      "type",
+                      "created_at",
+                      "updated_at"
+                    ]
+                  },
+                  "ldap_dn": {
+                    "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                    "type": "string",
+                    "examples": [
+                      "uid=example,ou=users,dc=github,dc=com"
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "node_id",
+                  "url",
+                  "members_url",
+                  "name",
+                  "description",
+                  "permission",
+                  "html_url",
+                  "repositories_url",
+                  "slug",
+                  "created_at",
+                  "updated_at",
+                  "members_count",
+                  "repos_count",
+                  "organization"
+                ]
+              }
+            }
+          },
+          {
+            "key": "default",
+            "request": {
+              "contentType": "application/json",
+              "description": "Example 2: Status Code 201",
               "acceptHeader": "application/vnd.github.v3+json",
               "bodyParameters": {
                 "name": "new team name",
@@ -472713,9 +473403,25 @@
         "previews": [],
         "descriptionHTML": "<p>To edit a team, the authenticated user must either be an organization owner or a team maintainer.</p>\n<p><strong>Note:</strong> You can also specify a team by <code>org_id</code> and <code>team_id</code> using the route <code>PATCH /organizations/{org_id}/team/{team_id}</code>.</p>",
         "statusCodes": [
+          {
+            "httpStatusCode": "200",
+            "description": "<p>Response when the updated information already exists</p>"
+          },
           {
             "httpStatusCode": "201",
             "description": "<p>Created</p>"
+          },
+          {
+            "httpStatusCode": "403",
+            "description": "<p>Forbidden</p>"
+          },
+          {
+            "httpStatusCode": "404",
+            "description": "<p>Resource not found</p>"
+          },
+          {
+            "httpStatusCode": "422",
+            "description": "<p>Validation failed</p>"
           }
         ],
         "subcategory": "teams"
diff --git a/lib/rest/static/decorated/github.ae.json b/lib/rest/static/decorated/github.ae.json
index 485bae7092..cc8f6b01a1 100644
--- a/lib/rest/static/decorated/github.ae.json
+++ b/lib/rest/static/decorated/github.ae.json
@@ -157941,6 +157941,7 @@
             "description": "<p>The base branch and head branch to compare. This parameter expects the format <code>{base}...{head}</code>.</p>",
             "in": "path",
             "required": true,
+            "x-multi-segment": true,
             "schema": {
               "type": "string"
             }
@@ -404299,7 +404300,697 @@
             "key": "default",
             "request": {
               "contentType": "application/json",
-              "description": "Example",
+              "description": "Example 1: Status Code 200",
+              "acceptHeader": "application/vnd.github.v3+json",
+              "bodyParameters": {
+                "name": "new team name",
+                "description": "new team description",
+                "privacy": "closed"
+              },
+              "parameters": {
+                "org": "ORG",
+                "team_slug": "TEAM_SLUG"
+              }
+            },
+            "response": {
+              "statusCode": "200",
+              "contentType": "application/json",
+              "description": "<p>Response when the updated information already exists</p>",
+              "example": {
+                "id": 1,
+                "node_id": "MDQ6VGVhbTE=",
+                "url": "https://api.github.com/teams/1",
+                "html_url": "https://github.com/orgs/github/teams/justice-league",
+                "name": "Justice League",
+                "slug": "justice-league",
+                "description": "A great team.",
+                "privacy": "closed",
+                "permission": "admin",
+                "members_url": "https://api.github.com/teams/1/members{/member}",
+                "repositories_url": "https://api.github.com/teams/1/repos",
+                "parent": null,
+                "members_count": 3,
+                "repos_count": 10,
+                "created_at": "2017-07-14T16:53:42Z",
+                "updated_at": "2017-08-17T12:37:15Z",
+                "organization": {
+                  "login": "github",
+                  "id": 1,
+                  "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
+                  "url": "https://api.github.com/orgs/github",
+                  "repos_url": "https://api.github.com/orgs/github/repos",
+                  "events_url": "https://api.github.com/orgs/github/events",
+                  "hooks_url": "https://api.github.com/orgs/github/hooks",
+                  "issues_url": "https://api.github.com/orgs/github/issues",
+                  "members_url": "https://api.github.com/orgs/github/members{/member}",
+                  "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
+                  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+                  "description": "A great organization",
+                  "name": "github",
+                  "company": "GitHub",
+                  "blog": "https://github.com/blog",
+                  "location": "San Francisco",
+                  "email": "octocat@github.com",
+                  "is_verified": true,
+                  "has_organization_projects": true,
+                  "has_repository_projects": true,
+                  "public_repos": 2,
+                  "public_gists": 1,
+                  "followers": 20,
+                  "following": 0,
+                  "html_url": "https://github.com/octocat",
+                  "created_at": "2008-01-14T04:33:35Z",
+                  "updated_at": "2017-08-17T12:37:15Z",
+                  "type": "Organization"
+                }
+              },
+              "schema": {
+                "title": "Full Team",
+                "description": "Groups of organization members that gives permissions on specified repositories.",
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "description": "Unique identifier of the team",
+                    "type": "integer",
+                    "examples": [
+                      42
+                    ]
+                  },
+                  "node_id": {
+                    "type": "string",
+                    "examples": [
+                      "MDQ6VGVhbTE="
+                    ]
+                  },
+                  "url": {
+                    "description": "URL for the team",
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1"
+                    ]
+                  },
+                  "html_url": {
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://github.com/orgs/rails/teams/core"
+                    ]
+                  },
+                  "name": {
+                    "description": "Name of the team",
+                    "type": "string",
+                    "examples": [
+                      "Developers"
+                    ]
+                  },
+                  "slug": {
+                    "type": "string",
+                    "examples": [
+                      "justice-league"
+                    ]
+                  },
+                  "description": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "examples": [
+                      "A great team."
+                    ]
+                  },
+                  "privacy": {
+                    "description": "The level of privacy this team should have",
+                    "type": "string",
+                    "enum": [
+                      "closed",
+                      "secret"
+                    ],
+                    "examples": [
+                      "closed"
+                    ]
+                  },
+                  "permission": {
+                    "description": "Permission that the team will have for its repositories",
+                    "type": "string",
+                    "examples": [
+                      "push"
+                    ]
+                  },
+                  "members_url": {
+                    "type": "string",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1/members{/member}"
+                    ]
+                  },
+                  "repositories_url": {
+                    "type": "string",
+                    "format": "uri",
+                    "examples": [
+                      "https://api.github.com/organizations/1/team/1/repos"
+                    ]
+                  },
+                  "parent": {
+                    "anyOf": [
+                      {
+                        "type": "null"
+                      },
+                      {
+                        "title": "Team Simple",
+                        "description": "Groups of organization members that gives permissions on specified repositories.",
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "description": "Unique identifier of the team",
+                            "type": "integer",
+                            "examples": [
+                              1
+                            ]
+                          },
+                          "node_id": {
+                            "type": "string",
+                            "examples": [
+                              "MDQ6VGVhbTE="
+                            ]
+                          },
+                          "url": {
+                            "description": "URL for the team",
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1"
+                            ]
+                          },
+                          "members_url": {
+                            "type": "string",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1/members{/member}"
+                            ]
+                          },
+                          "name": {
+                            "description": "Name of the team",
+                            "type": "string",
+                            "examples": [
+                              "Justice League"
+                            ]
+                          },
+                          "description": {
+                            "description": "Description of the team",
+                            "type": [
+                              "string",
+                              "null"
+                            ],
+                            "examples": [
+                              "A great team."
+                            ]
+                          },
+                          "permission": {
+                            "description": "Permission that the team will have for its repositories",
+                            "type": "string",
+                            "examples": [
+                              "admin"
+                            ]
+                          },
+                          "privacy": {
+                            "description": "The level of privacy this team should have",
+                            "type": "string",
+                            "examples": [
+                              "closed"
+                            ]
+                          },
+                          "html_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://github.com/orgs/rails/teams/core"
+                            ]
+                          },
+                          "repositories_url": {
+                            "type": "string",
+                            "format": "uri",
+                            "examples": [
+                              "https://api.github.com/organizations/1/team/1/repos"
+                            ]
+                          },
+                          "slug": {
+                            "type": "string",
+                            "examples": [
+                              "justice-league"
+                            ]
+                          },
+                          "ldap_dn": {
+                            "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                            "type": "string",
+                            "examples": [
+                              "uid=example,ou=users,dc=github,dc=com"
+                            ]
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "node_id",
+                          "url",
+                          "members_url",
+                          "name",
+                          "description",
+                          "permission",
+                          "html_url",
+                          "repositories_url",
+                          "slug"
+                        ]
+                      }
+                    ]
+                  },
+                  "members_count": {
+                    "type": "integer",
+                    "examples": [
+                      3
+                    ]
+                  },
+                  "repos_count": {
+                    "type": "integer",
+                    "examples": [
+                      10
+                    ]
+                  },
+                  "created_at": {
+                    "type": "string",
+                    "format": "date-time",
+                    "examples": [
+                      "2017-07-14T16:53:42Z"
+                    ]
+                  },
+                  "updated_at": {
+                    "type": "string",
+                    "format": "date-time",
+                    "examples": [
+                      "2017-08-17T12:37:15Z"
+                    ]
+                  },
+                  "organization": {
+                    "title": "Team Organization",
+                    "description": "Team Organization",
+                    "type": "object",
+                    "properties": {
+                      "login": {
+                        "type": "string",
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "id": {
+                        "type": "integer",
+                        "examples": [
+                          1
+                        ]
+                      },
+                      "node_id": {
+                        "type": "string",
+                        "examples": [
+                          "MDEyOk9yZ2FuaXphdGlvbjE="
+                        ]
+                      },
+                      "url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github"
+                        ]
+                      },
+                      "repos_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github/repos"
+                        ]
+                      },
+                      "events_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://api.github.com/orgs/github/events"
+                        ]
+                      },
+                      "hooks_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/hooks"
+                        ]
+                      },
+                      "issues_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/issues"
+                        ]
+                      },
+                      "members_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/members{/member}"
+                        ]
+                      },
+                      "public_members_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://api.github.com/orgs/github/public_members{/member}"
+                        ]
+                      },
+                      "avatar_url": {
+                        "type": "string",
+                        "examples": [
+                          "https://github.com/images/error/octocat_happy.gif"
+                        ]
+                      },
+                      "description": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "examples": [
+                          "A great organization"
+                        ]
+                      },
+                      "name": {
+                        "type": "string",
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "company": {
+                        "type": "string",
+                        "examples": [
+                          "GitHub"
+                        ]
+                      },
+                      "blog": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://github.com/blog"
+                        ]
+                      },
+                      "location": {
+                        "type": "string",
+                        "examples": [
+                          "San Francisco"
+                        ]
+                      },
+                      "email": {
+                        "type": "string",
+                        "format": "email",
+                        "examples": [
+                          "octocat@github.com"
+                        ]
+                      },
+                      "twitter_username": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "examples": [
+                          "github"
+                        ]
+                      },
+                      "is_verified": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "has_organization_projects": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "has_repository_projects": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "public_repos": {
+                        "type": "integer",
+                        "examples": [
+                          2
+                        ]
+                      },
+                      "public_gists": {
+                        "type": "integer",
+                        "examples": [
+                          1
+                        ]
+                      },
+                      "followers": {
+                        "type": "integer",
+                        "examples": [
+                          20
+                        ]
+                      },
+                      "following": {
+                        "type": "integer",
+                        "examples": [
+                          0
+                        ]
+                      },
+                      "html_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "examples": [
+                          "https://github.com/octocat"
+                        ]
+                      },
+                      "created_at": {
+                        "type": "string",
+                        "format": "date-time",
+                        "examples": [
+                          "2008-01-14T04:33:35Z"
+                        ]
+                      },
+                      "type": {
+                        "type": "string",
+                        "examples": [
+                          "Organization"
+                        ]
+                      },
+                      "total_private_repos": {
+                        "type": "integer",
+                        "examples": [
+                          100
+                        ]
+                      },
+                      "owned_private_repos": {
+                        "type": "integer",
+                        "examples": [
+                          100
+                        ]
+                      },
+                      "private_gists": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          81
+                        ]
+                      },
+                      "disk_usage": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          10000
+                        ]
+                      },
+                      "collaborators": {
+                        "type": [
+                          "integer",
+                          "null"
+                        ],
+                        "examples": [
+                          8
+                        ]
+                      },
+                      "billing_email": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "format": "email",
+                        "examples": [
+                          "org@example.com"
+                        ]
+                      },
+                      "plan": {
+                        "type": "object",
+                        "properties": {
+                          "name": {
+                            "type": "string"
+                          },
+                          "space": {
+                            "type": "integer"
+                          },
+                          "private_repos": {
+                            "type": "integer"
+                          },
+                          "filled_seats": {
+                            "type": "integer"
+                          },
+                          "seats": {
+                            "type": "integer"
+                          }
+                        },
+                        "required": [
+                          "name",
+                          "space",
+                          "private_repos"
+                        ]
+                      },
+                      "default_repository_permission": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "members_can_create_repositories": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "two_factor_requirement_enabled": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_allowed_repository_creation_type": {
+                        "type": "string",
+                        "examples": [
+                          "all"
+                        ]
+                      },
+                      "members_can_create_public_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_private_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_internal_repositories": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_public_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_create_private_pages": {
+                        "type": "boolean",
+                        "examples": [
+                          true
+                        ]
+                      },
+                      "members_can_fork_private_repositories": {
+                        "type": [
+                          "boolean",
+                          "null"
+                        ],
+                        "examples": [
+                          false
+                        ]
+                      },
+                      "web_commit_signoff_required": {
+                        "type": "boolean",
+                        "examples": [
+                          false
+                        ]
+                      },
+                      "updated_at": {
+                        "type": "string",
+                        "format": "date-time"
+                      }
+                    },
+                    "required": [
+                      "login",
+                      "url",
+                      "id",
+                      "node_id",
+                      "repos_url",
+                      "events_url",
+                      "hooks_url",
+                      "issues_url",
+                      "members_url",
+                      "public_members_url",
+                      "avatar_url",
+                      "description",
+                      "html_url",
+                      "has_organization_projects",
+                      "has_repository_projects",
+                      "public_repos",
+                      "public_gists",
+                      "followers",
+                      "following",
+                      "type",
+                      "created_at",
+                      "updated_at"
+                    ]
+                  },
+                  "ldap_dn": {
+                    "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                    "type": "string",
+                    "examples": [
+                      "uid=example,ou=users,dc=github,dc=com"
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "node_id",
+                  "url",
+                  "members_url",
+                  "name",
+                  "description",
+                  "permission",
+                  "html_url",
+                  "repositories_url",
+                  "slug",
+                  "created_at",
+                  "updated_at",
+                  "members_count",
+                  "repos_count",
+                  "organization"
+                ]
+              }
+            }
+          },
+          {
+            "key": "default",
+            "request": {
+              "contentType": "application/json",
+              "description": "Example 2: Status Code 201",
               "acceptHeader": "application/vnd.github.v3+json",
               "bodyParameters": {
                 "name": "new team name",
@@ -404989,9 +405680,25 @@
         "previews": [],
         "descriptionHTML": "<p>To edit a team, the authenticated user must either be an organization owner or a team maintainer.</p>\n<p><strong>Note:</strong> You can also specify a team by <code>org_id</code> and <code>team_id</code> using the route <code>PATCH /organizations/{org_id}/team/{team_id}</code>.</p>",
         "statusCodes": [
+          {
+            "httpStatusCode": "200",
+            "description": "<p>Response when the updated information already exists</p>"
+          },
           {
             "httpStatusCode": "201",
             "description": "<p>Created</p>"
+          },
+          {
+            "httpStatusCode": "403",
+            "description": "<p>Forbidden</p>"
+          },
+          {
+            "httpStatusCode": "404",
+            "description": "<p>Resource not found</p>"
+          },
+          {
+            "httpStatusCode": "422",
+            "description": "<p>Validation failed</p>"
           }
         ],
         "subcategory": "teams"
diff --git a/lib/rest/static/dereferenced/api.github.com.deref.json b/lib/rest/static/dereferenced/api.github.com.deref.json
index 639b80c36a..aaf455383f 100644
--- a/lib/rest/static/dereferenced/api.github.com.deref.json
+++ b/lib/rest/static/dereferenced/api.github.com.deref.json
@@ -130319,6 +130319,685 @@
           }
         },
         "responses": {
+          "200": {
+            "description": "Response when the updated information already exists",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Full Team",
+                  "description": "Groups of organization members that gives permissions on specified repositories.",
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "description": "Unique identifier of the team",
+                      "type": "integer",
+                      "examples": [
+                        42
+                      ]
+                    },
+                    "node_id": {
+                      "type": "string",
+                      "examples": [
+                        "MDQ6VGVhbTE="
+                      ]
+                    },
+                    "url": {
+                      "description": "URL for the team",
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1"
+                      ]
+                    },
+                    "html_url": {
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://github.com/orgs/rails/teams/core"
+                      ]
+                    },
+                    "name": {
+                      "description": "Name of the team",
+                      "type": "string",
+                      "examples": [
+                        "Developers"
+                      ]
+                    },
+                    "slug": {
+                      "type": "string",
+                      "examples": [
+                        "justice-league"
+                      ]
+                    },
+                    "description": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "examples": [
+                        "A great team."
+                      ]
+                    },
+                    "privacy": {
+                      "description": "The level of privacy this team should have",
+                      "type": "string",
+                      "enum": [
+                        "closed",
+                        "secret"
+                      ],
+                      "examples": [
+                        "closed"
+                      ]
+                    },
+                    "permission": {
+                      "description": "Permission that the team will have for its repositories",
+                      "type": "string",
+                      "examples": [
+                        "push"
+                      ]
+                    },
+                    "members_url": {
+                      "type": "string",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1/members{/member}"
+                      ]
+                    },
+                    "repositories_url": {
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1/repos"
+                      ]
+                    },
+                    "parent": {
+                      "anyOf": [
+                        {
+                          "type": "null"
+                        },
+                        {
+                          "title": "Team Simple",
+                          "description": "Groups of organization members that gives permissions on specified repositories.",
+                          "type": "object",
+                          "properties": {
+                            "id": {
+                              "description": "Unique identifier of the team",
+                              "type": "integer",
+                              "examples": [
+                                1
+                              ]
+                            },
+                            "node_id": {
+                              "type": "string",
+                              "examples": [
+                                "MDQ6VGVhbTE="
+                              ]
+                            },
+                            "url": {
+                              "description": "URL for the team",
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1"
+                              ]
+                            },
+                            "members_url": {
+                              "type": "string",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1/members{/member}"
+                              ]
+                            },
+                            "name": {
+                              "description": "Name of the team",
+                              "type": "string",
+                              "examples": [
+                                "Justice League"
+                              ]
+                            },
+                            "description": {
+                              "description": "Description of the team",
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "examples": [
+                                "A great team."
+                              ]
+                            },
+                            "permission": {
+                              "description": "Permission that the team will have for its repositories",
+                              "type": "string",
+                              "examples": [
+                                "admin"
+                              ]
+                            },
+                            "privacy": {
+                              "description": "The level of privacy this team should have",
+                              "type": "string",
+                              "examples": [
+                                "closed"
+                              ]
+                            },
+                            "html_url": {
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://github.com/orgs/rails/teams/core"
+                              ]
+                            },
+                            "repositories_url": {
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1/repos"
+                              ]
+                            },
+                            "slug": {
+                              "type": "string",
+                              "examples": [
+                                "justice-league"
+                              ]
+                            },
+                            "ldap_dn": {
+                              "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                              "type": "string",
+                              "examples": [
+                                "uid=example,ou=users,dc=github,dc=com"
+                              ]
+                            }
+                          },
+                          "required": [
+                            "id",
+                            "node_id",
+                            "url",
+                            "members_url",
+                            "name",
+                            "description",
+                            "permission",
+                            "html_url",
+                            "repositories_url",
+                            "slug"
+                          ]
+                        }
+                      ]
+                    },
+                    "members_count": {
+                      "type": "integer",
+                      "examples": [
+                        3
+                      ]
+                    },
+                    "repos_count": {
+                      "type": "integer",
+                      "examples": [
+                        10
+                      ]
+                    },
+                    "created_at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "examples": [
+                        "2017-07-14T16:53:42Z"
+                      ]
+                    },
+                    "updated_at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "examples": [
+                        "2017-08-17T12:37:15Z"
+                      ]
+                    },
+                    "organization": {
+                      "title": "Team Organization",
+                      "description": "Team Organization",
+                      "type": "object",
+                      "properties": {
+                        "login": {
+                          "type": "string",
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "id": {
+                          "type": "integer",
+                          "examples": [
+                            1
+                          ]
+                        },
+                        "node_id": {
+                          "type": "string",
+                          "examples": [
+                            "MDEyOk9yZ2FuaXphdGlvbjE="
+                          ]
+                        },
+                        "url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github"
+                          ]
+                        },
+                        "repos_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github/repos"
+                          ]
+                        },
+                        "events_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github/events"
+                          ]
+                        },
+                        "hooks_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/hooks"
+                          ]
+                        },
+                        "issues_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/issues"
+                          ]
+                        },
+                        "members_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/members{/member}"
+                          ]
+                        },
+                        "public_members_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/public_members{/member}"
+                          ]
+                        },
+                        "avatar_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://github.com/images/error/octocat_happy.gif"
+                          ]
+                        },
+                        "description": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "examples": [
+                            "A great organization"
+                          ]
+                        },
+                        "name": {
+                          "type": "string",
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "company": {
+                          "type": "string",
+                          "examples": [
+                            "GitHub"
+                          ]
+                        },
+                        "blog": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://github.com/blog"
+                          ]
+                        },
+                        "location": {
+                          "type": "string",
+                          "examples": [
+                            "San Francisco"
+                          ]
+                        },
+                        "email": {
+                          "type": "string",
+                          "format": "email",
+                          "examples": [
+                            "octocat@github.com"
+                          ]
+                        },
+                        "twitter_username": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "is_verified": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "has_organization_projects": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "has_repository_projects": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "public_repos": {
+                          "type": "integer",
+                          "examples": [
+                            2
+                          ]
+                        },
+                        "public_gists": {
+                          "type": "integer",
+                          "examples": [
+                            1
+                          ]
+                        },
+                        "followers": {
+                          "type": "integer",
+                          "examples": [
+                            20
+                          ]
+                        },
+                        "following": {
+                          "type": "integer",
+                          "examples": [
+                            0
+                          ]
+                        },
+                        "html_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://github.com/octocat"
+                          ]
+                        },
+                        "created_at": {
+                          "type": "string",
+                          "format": "date-time",
+                          "examples": [
+                            "2008-01-14T04:33:35Z"
+                          ]
+                        },
+                        "type": {
+                          "type": "string",
+                          "examples": [
+                            "Organization"
+                          ]
+                        },
+                        "total_private_repos": {
+                          "type": "integer",
+                          "examples": [
+                            100
+                          ]
+                        },
+                        "owned_private_repos": {
+                          "type": "integer",
+                          "examples": [
+                            100
+                          ]
+                        },
+                        "private_gists": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            81
+                          ]
+                        },
+                        "disk_usage": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            10000
+                          ]
+                        },
+                        "collaborators": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            8
+                          ]
+                        },
+                        "billing_email": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "format": "email",
+                          "examples": [
+                            "org@example.com"
+                          ]
+                        },
+                        "plan": {
+                          "type": "object",
+                          "properties": {
+                            "name": {
+                              "type": "string"
+                            },
+                            "space": {
+                              "type": "integer"
+                            },
+                            "private_repos": {
+                              "type": "integer"
+                            },
+                            "filled_seats": {
+                              "type": "integer"
+                            },
+                            "seats": {
+                              "type": "integer"
+                            }
+                          },
+                          "required": [
+                            "name",
+                            "space",
+                            "private_repos"
+                          ]
+                        },
+                        "default_repository_permission": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "members_can_create_repositories": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "two_factor_requirement_enabled": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_allowed_repository_creation_type": {
+                          "type": "string",
+                          "examples": [
+                            "all"
+                          ]
+                        },
+                        "members_can_create_public_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_private_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_internal_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_public_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_private_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_fork_private_repositories": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            false
+                          ]
+                        },
+                        "web_commit_signoff_required": {
+                          "type": "boolean",
+                          "examples": [
+                            false
+                          ]
+                        },
+                        "updated_at": {
+                          "type": "string",
+                          "format": "date-time"
+                        }
+                      },
+                      "required": [
+                        "login",
+                        "url",
+                        "id",
+                        "node_id",
+                        "repos_url",
+                        "events_url",
+                        "hooks_url",
+                        "issues_url",
+                        "members_url",
+                        "public_members_url",
+                        "avatar_url",
+                        "description",
+                        "html_url",
+                        "has_organization_projects",
+                        "has_repository_projects",
+                        "public_repos",
+                        "public_gists",
+                        "followers",
+                        "following",
+                        "type",
+                        "created_at",
+                        "updated_at"
+                      ]
+                    },
+                    "ldap_dn": {
+                      "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                      "type": "string",
+                      "examples": [
+                        "uid=example,ou=users,dc=github,dc=com"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "node_id",
+                    "url",
+                    "members_url",
+                    "name",
+                    "description",
+                    "permission",
+                    "html_url",
+                    "repositories_url",
+                    "slug",
+                    "created_at",
+                    "updated_at",
+                    "members_count",
+                    "repos_count",
+                    "organization"
+                  ]
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "id": 1,
+                      "node_id": "MDQ6VGVhbTE=",
+                      "url": "https://api.github.com/teams/1",
+                      "html_url": "https://github.com/orgs/github/teams/justice-league",
+                      "name": "Justice League",
+                      "slug": "justice-league",
+                      "description": "A great team.",
+                      "privacy": "closed",
+                      "permission": "admin",
+                      "members_url": "https://api.github.com/teams/1/members{/member}",
+                      "repositories_url": "https://api.github.com/teams/1/repos",
+                      "parent": null,
+                      "members_count": 3,
+                      "repos_count": 10,
+                      "created_at": "2017-07-14T16:53:42Z",
+                      "updated_at": "2017-08-17T12:37:15Z",
+                      "organization": {
+                        "login": "github",
+                        "id": 1,
+                        "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
+                        "url": "https://api.github.com/orgs/github",
+                        "repos_url": "https://api.github.com/orgs/github/repos",
+                        "events_url": "https://api.github.com/orgs/github/events",
+                        "hooks_url": "https://api.github.com/orgs/github/hooks",
+                        "issues_url": "https://api.github.com/orgs/github/issues",
+                        "members_url": "https://api.github.com/orgs/github/members{/member}",
+                        "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
+                        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+                        "description": "A great organization",
+                        "name": "github",
+                        "company": "GitHub",
+                        "blog": "https://github.com/blog",
+                        "location": "San Francisco",
+                        "email": "octocat@github.com",
+                        "is_verified": true,
+                        "has_organization_projects": true,
+                        "has_repository_projects": true,
+                        "public_repos": 2,
+                        "public_gists": 1,
+                        "followers": 20,
+                        "following": 0,
+                        "html_url": "https://github.com/octocat",
+                        "created_at": "2008-01-14T04:33:35Z",
+                        "updated_at": "2017-08-17T12:37:15Z",
+                        "type": "Organization"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
           "201": {
             "description": "Response",
             "content": {
@@ -130997,6 +131676,133 @@
                 }
               }
             }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Validation Error",
+                  "description": "Validation Error",
+                  "type": "object",
+                  "required": [
+                    "message",
+                    "documentation_url"
+                  ],
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "code"
+                        ],
+                        "properties": {
+                          "resource": {
+                            "type": "string"
+                          },
+                          "field": {
+                            "type": "string"
+                          },
+                          "message": {
+                            "type": "string"
+                          },
+                          "code": {
+                            "type": "string"
+                          },
+                          "index": {
+                            "type": "integer"
+                          },
+                          "value": {
+                            "oneOf": [
+                              {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              {
+                                "type": [
+                                  "integer",
+                                  "null"
+                                ]
+                              },
+                              {
+                                "type": [
+                                  "array",
+                                  "null"
+                                ],
+                                "items": {
+                                  "type": "string"
+                                }
+                              }
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           }
         },
         "x-github": {
@@ -279408,6 +280214,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"
             }
diff --git a/lib/rest/static/dereferenced/ghes-3.2.deref.json b/lib/rest/static/dereferenced/ghes-3.2.deref.json
index 2ce2dea77f..72f0f891f4 100644
--- a/lib/rest/static/dereferenced/ghes-3.2.deref.json
+++ b/lib/rest/static/dereferenced/ghes-3.2.deref.json
@@ -103450,6 +103450,669 @@
           }
         },
         "responses": {
+          "200": {
+            "description": "Response when the updated information already exists",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Full Team",
+                  "description": "Groups of organization members that gives permissions on specified repositories.",
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "description": "Unique identifier of the team",
+                      "type": "integer",
+                      "examples": [
+                        42
+                      ]
+                    },
+                    "node_id": {
+                      "type": "string",
+                      "examples": [
+                        "MDQ6VGVhbTE="
+                      ]
+                    },
+                    "url": {
+                      "description": "URL for the team",
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1"
+                      ]
+                    },
+                    "html_url": {
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://github.com/orgs/rails/teams/core"
+                      ]
+                    },
+                    "name": {
+                      "description": "Name of the team",
+                      "type": "string",
+                      "examples": [
+                        "Developers"
+                      ]
+                    },
+                    "slug": {
+                      "type": "string",
+                      "examples": [
+                        "justice-league"
+                      ]
+                    },
+                    "description": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "examples": [
+                        "A great team."
+                      ]
+                    },
+                    "privacy": {
+                      "description": "The level of privacy this team should have",
+                      "type": "string",
+                      "enum": [
+                        "closed",
+                        "secret"
+                      ],
+                      "examples": [
+                        "closed"
+                      ]
+                    },
+                    "permission": {
+                      "description": "Permission that the team will have for its repositories",
+                      "type": "string",
+                      "examples": [
+                        "push"
+                      ]
+                    },
+                    "members_url": {
+                      "type": "string",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1/members{/member}"
+                      ]
+                    },
+                    "repositories_url": {
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1/repos"
+                      ]
+                    },
+                    "parent": {
+                      "anyOf": [
+                        {
+                          "type": "null"
+                        },
+                        {
+                          "title": "Team Simple",
+                          "description": "Groups of organization members that gives permissions on specified repositories.",
+                          "type": "object",
+                          "properties": {
+                            "id": {
+                              "description": "Unique identifier of the team",
+                              "type": "integer",
+                              "examples": [
+                                1
+                              ]
+                            },
+                            "node_id": {
+                              "type": "string",
+                              "examples": [
+                                "MDQ6VGVhbTE="
+                              ]
+                            },
+                            "url": {
+                              "description": "URL for the team",
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1"
+                              ]
+                            },
+                            "members_url": {
+                              "type": "string",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1/members{/member}"
+                              ]
+                            },
+                            "name": {
+                              "description": "Name of the team",
+                              "type": "string",
+                              "examples": [
+                                "Justice League"
+                              ]
+                            },
+                            "description": {
+                              "description": "Description of the team",
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "examples": [
+                                "A great team."
+                              ]
+                            },
+                            "permission": {
+                              "description": "Permission that the team will have for its repositories",
+                              "type": "string",
+                              "examples": [
+                                "admin"
+                              ]
+                            },
+                            "privacy": {
+                              "description": "The level of privacy this team should have",
+                              "type": "string",
+                              "examples": [
+                                "closed"
+                              ]
+                            },
+                            "html_url": {
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://github.com/orgs/rails/teams/core"
+                              ]
+                            },
+                            "repositories_url": {
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1/repos"
+                              ]
+                            },
+                            "slug": {
+                              "type": "string",
+                              "examples": [
+                                "justice-league"
+                              ]
+                            },
+                            "ldap_dn": {
+                              "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                              "type": "string",
+                              "examples": [
+                                "uid=example,ou=users,dc=github,dc=com"
+                              ]
+                            }
+                          },
+                          "required": [
+                            "id",
+                            "node_id",
+                            "url",
+                            "members_url",
+                            "name",
+                            "description",
+                            "permission",
+                            "html_url",
+                            "repositories_url",
+                            "slug"
+                          ]
+                        }
+                      ]
+                    },
+                    "members_count": {
+                      "type": "integer",
+                      "examples": [
+                        3
+                      ]
+                    },
+                    "repos_count": {
+                      "type": "integer",
+                      "examples": [
+                        10
+                      ]
+                    },
+                    "created_at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "examples": [
+                        "2017-07-14T16:53:42Z"
+                      ]
+                    },
+                    "updated_at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "examples": [
+                        "2017-08-17T12:37:15Z"
+                      ]
+                    },
+                    "organization": {
+                      "title": "Team Organization",
+                      "description": "Team Organization",
+                      "type": "object",
+                      "properties": {
+                        "login": {
+                          "type": "string",
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "id": {
+                          "type": "integer",
+                          "examples": [
+                            1
+                          ]
+                        },
+                        "node_id": {
+                          "type": "string",
+                          "examples": [
+                            "MDEyOk9yZ2FuaXphdGlvbjE="
+                          ]
+                        },
+                        "url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github"
+                          ]
+                        },
+                        "repos_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github/repos"
+                          ]
+                        },
+                        "events_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github/events"
+                          ]
+                        },
+                        "hooks_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/hooks"
+                          ]
+                        },
+                        "issues_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/issues"
+                          ]
+                        },
+                        "members_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/members{/member}"
+                          ]
+                        },
+                        "public_members_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/public_members{/member}"
+                          ]
+                        },
+                        "avatar_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://github.com/images/error/octocat_happy.gif"
+                          ]
+                        },
+                        "description": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "examples": [
+                            "A great organization"
+                          ]
+                        },
+                        "name": {
+                          "type": "string",
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "company": {
+                          "type": "string",
+                          "examples": [
+                            "GitHub"
+                          ]
+                        },
+                        "blog": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://github.com/blog"
+                          ]
+                        },
+                        "location": {
+                          "type": "string",
+                          "examples": [
+                            "San Francisco"
+                          ]
+                        },
+                        "email": {
+                          "type": "string",
+                          "format": "email",
+                          "examples": [
+                            "octocat@github.com"
+                          ]
+                        },
+                        "twitter_username": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "is_verified": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "has_organization_projects": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "has_repository_projects": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "public_repos": {
+                          "type": "integer",
+                          "examples": [
+                            2
+                          ]
+                        },
+                        "public_gists": {
+                          "type": "integer",
+                          "examples": [
+                            1
+                          ]
+                        },
+                        "followers": {
+                          "type": "integer",
+                          "examples": [
+                            20
+                          ]
+                        },
+                        "following": {
+                          "type": "integer",
+                          "examples": [
+                            0
+                          ]
+                        },
+                        "html_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://github.com/octocat"
+                          ]
+                        },
+                        "created_at": {
+                          "type": "string",
+                          "format": "date-time",
+                          "examples": [
+                            "2008-01-14T04:33:35Z"
+                          ]
+                        },
+                        "type": {
+                          "type": "string",
+                          "examples": [
+                            "Organization"
+                          ]
+                        },
+                        "total_private_repos": {
+                          "type": "integer",
+                          "examples": [
+                            100
+                          ]
+                        },
+                        "owned_private_repos": {
+                          "type": "integer",
+                          "examples": [
+                            100
+                          ]
+                        },
+                        "private_gists": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            81
+                          ]
+                        },
+                        "disk_usage": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            10000
+                          ]
+                        },
+                        "collaborators": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            8
+                          ]
+                        },
+                        "billing_email": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "format": "email",
+                          "examples": [
+                            "org@example.com"
+                          ]
+                        },
+                        "plan": {
+                          "type": "object",
+                          "properties": {
+                            "name": {
+                              "type": "string"
+                            },
+                            "space": {
+                              "type": "integer"
+                            },
+                            "private_repos": {
+                              "type": "integer"
+                            },
+                            "filled_seats": {
+                              "type": "integer"
+                            },
+                            "seats": {
+                              "type": "integer"
+                            }
+                          },
+                          "required": [
+                            "name",
+                            "space",
+                            "private_repos"
+                          ]
+                        },
+                        "default_repository_permission": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "members_can_create_repositories": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "two_factor_requirement_enabled": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_allowed_repository_creation_type": {
+                          "type": "string",
+                          "examples": [
+                            "all"
+                          ]
+                        },
+                        "members_can_create_public_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_private_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_internal_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_public_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_private_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "updated_at": {
+                          "type": "string",
+                          "format": "date-time"
+                        }
+                      },
+                      "required": [
+                        "login",
+                        "url",
+                        "id",
+                        "node_id",
+                        "repos_url",
+                        "events_url",
+                        "hooks_url",
+                        "issues_url",
+                        "members_url",
+                        "public_members_url",
+                        "avatar_url",
+                        "description",
+                        "html_url",
+                        "has_organization_projects",
+                        "has_repository_projects",
+                        "public_repos",
+                        "public_gists",
+                        "followers",
+                        "following",
+                        "type",
+                        "created_at",
+                        "updated_at"
+                      ]
+                    },
+                    "ldap_dn": {
+                      "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                      "type": "string",
+                      "examples": [
+                        "uid=example,ou=users,dc=github,dc=com"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "node_id",
+                    "url",
+                    "members_url",
+                    "name",
+                    "description",
+                    "permission",
+                    "html_url",
+                    "repositories_url",
+                    "slug",
+                    "created_at",
+                    "updated_at",
+                    "members_count",
+                    "repos_count",
+                    "organization"
+                  ]
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "id": 1,
+                      "node_id": "MDQ6VGVhbTE=",
+                      "url": "https://api.github.com/teams/1",
+                      "html_url": "https://github.com/orgs/github/teams/justice-league",
+                      "name": "Justice League",
+                      "slug": "justice-league",
+                      "description": "A great team.",
+                      "privacy": "closed",
+                      "permission": "admin",
+                      "members_url": "https://api.github.com/teams/1/members{/member}",
+                      "repositories_url": "https://api.github.com/teams/1/repos",
+                      "members_count": 3,
+                      "repos_count": 10,
+                      "created_at": "2017-07-14T16:53:42Z",
+                      "updated_at": "2017-08-17T12:37:15Z",
+                      "organization": {
+                        "login": "github",
+                        "id": 1,
+                        "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
+                        "url": "https://api.github.com/orgs/github",
+                        "repos_url": "https://api.github.com/orgs/github/repos",
+                        "events_url": "https://api.github.com/orgs/github/events",
+                        "hooks_url": "https://api.github.com/orgs/github/hooks",
+                        "issues_url": "https://api.github.com/orgs/github/issues",
+                        "members_url": "https://api.github.com/orgs/github/members{/member}",
+                        "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
+                        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+                        "description": "A great organization",
+                        "name": "github",
+                        "company": "GitHub",
+                        "blog": "https://github.com/blog",
+                        "location": "San Francisco",
+                        "email": "octocat@github.com",
+                        "has_organization_projects": true,
+                        "has_repository_projects": true,
+                        "public_repos": 2,
+                        "public_gists": 1,
+                        "followers": 20,
+                        "following": 0,
+                        "html_url": "https://github.com/octocat",
+                        "created_at": "2008-01-14T04:33:35Z",
+                        "updated_at": "2017-08-17T12:37:15Z",
+                        "type": "Organization"
+                      },
+                      "ldap_dn": "uid=asdf,ou=users,dc=github,dc=com"
+                    }
+                  }
+                }
+              }
+            }
+          },
           "201": {
             "description": "Response",
             "content": {
@@ -104112,6 +104775,133 @@
                 }
               }
             }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Validation Error",
+                  "description": "Validation Error",
+                  "type": "object",
+                  "required": [
+                    "message",
+                    "documentation_url"
+                  ],
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "code"
+                        ],
+                        "properties": {
+                          "resource": {
+                            "type": "string"
+                          },
+                          "field": {
+                            "type": "string"
+                          },
+                          "message": {
+                            "type": "string"
+                          },
+                          "code": {
+                            "type": "string"
+                          },
+                          "index": {
+                            "type": "integer"
+                          },
+                          "value": {
+                            "oneOf": [
+                              {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              {
+                                "type": [
+                                  "integer",
+                                  "null"
+                                ]
+                              },
+                              {
+                                "type": [
+                                  "array",
+                                  "null"
+                                ],
+                                "items": {
+                                  "type": "string"
+                                }
+                              }
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           }
         },
         "x-github": {
@@ -221411,6 +222201,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"
             }
diff --git a/lib/rest/static/dereferenced/ghes-3.3.deref.json b/lib/rest/static/dereferenced/ghes-3.3.deref.json
index 30a18bff56..70f0d595af 100644
--- a/lib/rest/static/dereferenced/ghes-3.3.deref.json
+++ b/lib/rest/static/dereferenced/ghes-3.3.deref.json
@@ -105346,6 +105346,669 @@
           }
         },
         "responses": {
+          "200": {
+            "description": "Response when the updated information already exists",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Full Team",
+                  "description": "Groups of organization members that gives permissions on specified repositories.",
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "description": "Unique identifier of the team",
+                      "type": "integer",
+                      "examples": [
+                        42
+                      ]
+                    },
+                    "node_id": {
+                      "type": "string",
+                      "examples": [
+                        "MDQ6VGVhbTE="
+                      ]
+                    },
+                    "url": {
+                      "description": "URL for the team",
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1"
+                      ]
+                    },
+                    "html_url": {
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://github.com/orgs/rails/teams/core"
+                      ]
+                    },
+                    "name": {
+                      "description": "Name of the team",
+                      "type": "string",
+                      "examples": [
+                        "Developers"
+                      ]
+                    },
+                    "slug": {
+                      "type": "string",
+                      "examples": [
+                        "justice-league"
+                      ]
+                    },
+                    "description": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "examples": [
+                        "A great team."
+                      ]
+                    },
+                    "privacy": {
+                      "description": "The level of privacy this team should have",
+                      "type": "string",
+                      "enum": [
+                        "closed",
+                        "secret"
+                      ],
+                      "examples": [
+                        "closed"
+                      ]
+                    },
+                    "permission": {
+                      "description": "Permission that the team will have for its repositories",
+                      "type": "string",
+                      "examples": [
+                        "push"
+                      ]
+                    },
+                    "members_url": {
+                      "type": "string",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1/members{/member}"
+                      ]
+                    },
+                    "repositories_url": {
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1/repos"
+                      ]
+                    },
+                    "parent": {
+                      "anyOf": [
+                        {
+                          "type": "null"
+                        },
+                        {
+                          "title": "Team Simple",
+                          "description": "Groups of organization members that gives permissions on specified repositories.",
+                          "type": "object",
+                          "properties": {
+                            "id": {
+                              "description": "Unique identifier of the team",
+                              "type": "integer",
+                              "examples": [
+                                1
+                              ]
+                            },
+                            "node_id": {
+                              "type": "string",
+                              "examples": [
+                                "MDQ6VGVhbTE="
+                              ]
+                            },
+                            "url": {
+                              "description": "URL for the team",
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1"
+                              ]
+                            },
+                            "members_url": {
+                              "type": "string",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1/members{/member}"
+                              ]
+                            },
+                            "name": {
+                              "description": "Name of the team",
+                              "type": "string",
+                              "examples": [
+                                "Justice League"
+                              ]
+                            },
+                            "description": {
+                              "description": "Description of the team",
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "examples": [
+                                "A great team."
+                              ]
+                            },
+                            "permission": {
+                              "description": "Permission that the team will have for its repositories",
+                              "type": "string",
+                              "examples": [
+                                "admin"
+                              ]
+                            },
+                            "privacy": {
+                              "description": "The level of privacy this team should have",
+                              "type": "string",
+                              "examples": [
+                                "closed"
+                              ]
+                            },
+                            "html_url": {
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://github.com/orgs/rails/teams/core"
+                              ]
+                            },
+                            "repositories_url": {
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1/repos"
+                              ]
+                            },
+                            "slug": {
+                              "type": "string",
+                              "examples": [
+                                "justice-league"
+                              ]
+                            },
+                            "ldap_dn": {
+                              "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                              "type": "string",
+                              "examples": [
+                                "uid=example,ou=users,dc=github,dc=com"
+                              ]
+                            }
+                          },
+                          "required": [
+                            "id",
+                            "node_id",
+                            "url",
+                            "members_url",
+                            "name",
+                            "description",
+                            "permission",
+                            "html_url",
+                            "repositories_url",
+                            "slug"
+                          ]
+                        }
+                      ]
+                    },
+                    "members_count": {
+                      "type": "integer",
+                      "examples": [
+                        3
+                      ]
+                    },
+                    "repos_count": {
+                      "type": "integer",
+                      "examples": [
+                        10
+                      ]
+                    },
+                    "created_at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "examples": [
+                        "2017-07-14T16:53:42Z"
+                      ]
+                    },
+                    "updated_at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "examples": [
+                        "2017-08-17T12:37:15Z"
+                      ]
+                    },
+                    "organization": {
+                      "title": "Team Organization",
+                      "description": "Team Organization",
+                      "type": "object",
+                      "properties": {
+                        "login": {
+                          "type": "string",
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "id": {
+                          "type": "integer",
+                          "examples": [
+                            1
+                          ]
+                        },
+                        "node_id": {
+                          "type": "string",
+                          "examples": [
+                            "MDEyOk9yZ2FuaXphdGlvbjE="
+                          ]
+                        },
+                        "url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github"
+                          ]
+                        },
+                        "repos_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github/repos"
+                          ]
+                        },
+                        "events_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github/events"
+                          ]
+                        },
+                        "hooks_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/hooks"
+                          ]
+                        },
+                        "issues_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/issues"
+                          ]
+                        },
+                        "members_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/members{/member}"
+                          ]
+                        },
+                        "public_members_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/public_members{/member}"
+                          ]
+                        },
+                        "avatar_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://github.com/images/error/octocat_happy.gif"
+                          ]
+                        },
+                        "description": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "examples": [
+                            "A great organization"
+                          ]
+                        },
+                        "name": {
+                          "type": "string",
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "company": {
+                          "type": "string",
+                          "examples": [
+                            "GitHub"
+                          ]
+                        },
+                        "blog": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://github.com/blog"
+                          ]
+                        },
+                        "location": {
+                          "type": "string",
+                          "examples": [
+                            "San Francisco"
+                          ]
+                        },
+                        "email": {
+                          "type": "string",
+                          "format": "email",
+                          "examples": [
+                            "octocat@github.com"
+                          ]
+                        },
+                        "twitter_username": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "is_verified": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "has_organization_projects": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "has_repository_projects": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "public_repos": {
+                          "type": "integer",
+                          "examples": [
+                            2
+                          ]
+                        },
+                        "public_gists": {
+                          "type": "integer",
+                          "examples": [
+                            1
+                          ]
+                        },
+                        "followers": {
+                          "type": "integer",
+                          "examples": [
+                            20
+                          ]
+                        },
+                        "following": {
+                          "type": "integer",
+                          "examples": [
+                            0
+                          ]
+                        },
+                        "html_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://github.com/octocat"
+                          ]
+                        },
+                        "created_at": {
+                          "type": "string",
+                          "format": "date-time",
+                          "examples": [
+                            "2008-01-14T04:33:35Z"
+                          ]
+                        },
+                        "type": {
+                          "type": "string",
+                          "examples": [
+                            "Organization"
+                          ]
+                        },
+                        "total_private_repos": {
+                          "type": "integer",
+                          "examples": [
+                            100
+                          ]
+                        },
+                        "owned_private_repos": {
+                          "type": "integer",
+                          "examples": [
+                            100
+                          ]
+                        },
+                        "private_gists": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            81
+                          ]
+                        },
+                        "disk_usage": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            10000
+                          ]
+                        },
+                        "collaborators": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            8
+                          ]
+                        },
+                        "billing_email": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "format": "email",
+                          "examples": [
+                            "org@example.com"
+                          ]
+                        },
+                        "plan": {
+                          "type": "object",
+                          "properties": {
+                            "name": {
+                              "type": "string"
+                            },
+                            "space": {
+                              "type": "integer"
+                            },
+                            "private_repos": {
+                              "type": "integer"
+                            },
+                            "filled_seats": {
+                              "type": "integer"
+                            },
+                            "seats": {
+                              "type": "integer"
+                            }
+                          },
+                          "required": [
+                            "name",
+                            "space",
+                            "private_repos"
+                          ]
+                        },
+                        "default_repository_permission": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "members_can_create_repositories": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "two_factor_requirement_enabled": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_allowed_repository_creation_type": {
+                          "type": "string",
+                          "examples": [
+                            "all"
+                          ]
+                        },
+                        "members_can_create_public_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_private_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_internal_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_public_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_private_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "updated_at": {
+                          "type": "string",
+                          "format": "date-time"
+                        }
+                      },
+                      "required": [
+                        "login",
+                        "url",
+                        "id",
+                        "node_id",
+                        "repos_url",
+                        "events_url",
+                        "hooks_url",
+                        "issues_url",
+                        "members_url",
+                        "public_members_url",
+                        "avatar_url",
+                        "description",
+                        "html_url",
+                        "has_organization_projects",
+                        "has_repository_projects",
+                        "public_repos",
+                        "public_gists",
+                        "followers",
+                        "following",
+                        "type",
+                        "created_at",
+                        "updated_at"
+                      ]
+                    },
+                    "ldap_dn": {
+                      "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                      "type": "string",
+                      "examples": [
+                        "uid=example,ou=users,dc=github,dc=com"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "node_id",
+                    "url",
+                    "members_url",
+                    "name",
+                    "description",
+                    "permission",
+                    "html_url",
+                    "repositories_url",
+                    "slug",
+                    "created_at",
+                    "updated_at",
+                    "members_count",
+                    "repos_count",
+                    "organization"
+                  ]
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "id": 1,
+                      "node_id": "MDQ6VGVhbTE=",
+                      "url": "https://api.github.com/teams/1",
+                      "html_url": "https://github.com/orgs/github/teams/justice-league",
+                      "name": "Justice League",
+                      "slug": "justice-league",
+                      "description": "A great team.",
+                      "privacy": "closed",
+                      "permission": "admin",
+                      "members_url": "https://api.github.com/teams/1/members{/member}",
+                      "repositories_url": "https://api.github.com/teams/1/repos",
+                      "members_count": 3,
+                      "repos_count": 10,
+                      "created_at": "2017-07-14T16:53:42Z",
+                      "updated_at": "2017-08-17T12:37:15Z",
+                      "organization": {
+                        "login": "github",
+                        "id": 1,
+                        "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
+                        "url": "https://api.github.com/orgs/github",
+                        "repos_url": "https://api.github.com/orgs/github/repos",
+                        "events_url": "https://api.github.com/orgs/github/events",
+                        "hooks_url": "https://api.github.com/orgs/github/hooks",
+                        "issues_url": "https://api.github.com/orgs/github/issues",
+                        "members_url": "https://api.github.com/orgs/github/members{/member}",
+                        "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
+                        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+                        "description": "A great organization",
+                        "name": "github",
+                        "company": "GitHub",
+                        "blog": "https://github.com/blog",
+                        "location": "San Francisco",
+                        "email": "octocat@github.com",
+                        "has_organization_projects": true,
+                        "has_repository_projects": true,
+                        "public_repos": 2,
+                        "public_gists": 1,
+                        "followers": 20,
+                        "following": 0,
+                        "html_url": "https://github.com/octocat",
+                        "created_at": "2008-01-14T04:33:35Z",
+                        "updated_at": "2017-08-17T12:37:15Z",
+                        "type": "Organization"
+                      },
+                      "ldap_dn": "uid=asdf,ou=users,dc=github,dc=com"
+                    }
+                  }
+                }
+              }
+            }
+          },
           "201": {
             "description": "Response",
             "content": {
@@ -106008,6 +106671,133 @@
                 }
               }
             }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Validation Error",
+                  "description": "Validation Error",
+                  "type": "object",
+                  "required": [
+                    "message",
+                    "documentation_url"
+                  ],
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "code"
+                        ],
+                        "properties": {
+                          "resource": {
+                            "type": "string"
+                          },
+                          "field": {
+                            "type": "string"
+                          },
+                          "message": {
+                            "type": "string"
+                          },
+                          "code": {
+                            "type": "string"
+                          },
+                          "index": {
+                            "type": "integer"
+                          },
+                          "value": {
+                            "oneOf": [
+                              {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              {
+                                "type": [
+                                  "integer",
+                                  "null"
+                                ]
+                              },
+                              {
+                                "type": [
+                                  "array",
+                                  "null"
+                                ],
+                                "items": {
+                                  "type": "string"
+                                }
+                              }
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           }
         },
         "x-github": {
@@ -223561,6 +224351,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"
             }
diff --git a/lib/rest/static/dereferenced/ghes-3.4.deref.json b/lib/rest/static/dereferenced/ghes-3.4.deref.json
index bccf1bdeab..7638439a13 100644
--- a/lib/rest/static/dereferenced/ghes-3.4.deref.json
+++ b/lib/rest/static/dereferenced/ghes-3.4.deref.json
@@ -115579,6 +115579,678 @@
           }
         },
         "responses": {
+          "200": {
+            "description": "Response when the updated information already exists",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Full Team",
+                  "description": "Groups of organization members that gives permissions on specified repositories.",
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "description": "Unique identifier of the team",
+                      "type": "integer",
+                      "examples": [
+                        42
+                      ]
+                    },
+                    "node_id": {
+                      "type": "string",
+                      "examples": [
+                        "MDQ6VGVhbTE="
+                      ]
+                    },
+                    "url": {
+                      "description": "URL for the team",
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1"
+                      ]
+                    },
+                    "html_url": {
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://github.com/orgs/rails/teams/core"
+                      ]
+                    },
+                    "name": {
+                      "description": "Name of the team",
+                      "type": "string",
+                      "examples": [
+                        "Developers"
+                      ]
+                    },
+                    "slug": {
+                      "type": "string",
+                      "examples": [
+                        "justice-league"
+                      ]
+                    },
+                    "description": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "examples": [
+                        "A great team."
+                      ]
+                    },
+                    "privacy": {
+                      "description": "The level of privacy this team should have",
+                      "type": "string",
+                      "enum": [
+                        "closed",
+                        "secret"
+                      ],
+                      "examples": [
+                        "closed"
+                      ]
+                    },
+                    "permission": {
+                      "description": "Permission that the team will have for its repositories",
+                      "type": "string",
+                      "examples": [
+                        "push"
+                      ]
+                    },
+                    "members_url": {
+                      "type": "string",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1/members{/member}"
+                      ]
+                    },
+                    "repositories_url": {
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1/repos"
+                      ]
+                    },
+                    "parent": {
+                      "anyOf": [
+                        {
+                          "type": "null"
+                        },
+                        {
+                          "title": "Team Simple",
+                          "description": "Groups of organization members that gives permissions on specified repositories.",
+                          "type": "object",
+                          "properties": {
+                            "id": {
+                              "description": "Unique identifier of the team",
+                              "type": "integer",
+                              "examples": [
+                                1
+                              ]
+                            },
+                            "node_id": {
+                              "type": "string",
+                              "examples": [
+                                "MDQ6VGVhbTE="
+                              ]
+                            },
+                            "url": {
+                              "description": "URL for the team",
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1"
+                              ]
+                            },
+                            "members_url": {
+                              "type": "string",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1/members{/member}"
+                              ]
+                            },
+                            "name": {
+                              "description": "Name of the team",
+                              "type": "string",
+                              "examples": [
+                                "Justice League"
+                              ]
+                            },
+                            "description": {
+                              "description": "Description of the team",
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "examples": [
+                                "A great team."
+                              ]
+                            },
+                            "permission": {
+                              "description": "Permission that the team will have for its repositories",
+                              "type": "string",
+                              "examples": [
+                                "admin"
+                              ]
+                            },
+                            "privacy": {
+                              "description": "The level of privacy this team should have",
+                              "type": "string",
+                              "examples": [
+                                "closed"
+                              ]
+                            },
+                            "html_url": {
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://github.com/orgs/rails/teams/core"
+                              ]
+                            },
+                            "repositories_url": {
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1/repos"
+                              ]
+                            },
+                            "slug": {
+                              "type": "string",
+                              "examples": [
+                                "justice-league"
+                              ]
+                            },
+                            "ldap_dn": {
+                              "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                              "type": "string",
+                              "examples": [
+                                "uid=example,ou=users,dc=github,dc=com"
+                              ]
+                            }
+                          },
+                          "required": [
+                            "id",
+                            "node_id",
+                            "url",
+                            "members_url",
+                            "name",
+                            "description",
+                            "permission",
+                            "html_url",
+                            "repositories_url",
+                            "slug"
+                          ]
+                        }
+                      ]
+                    },
+                    "members_count": {
+                      "type": "integer",
+                      "examples": [
+                        3
+                      ]
+                    },
+                    "repos_count": {
+                      "type": "integer",
+                      "examples": [
+                        10
+                      ]
+                    },
+                    "created_at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "examples": [
+                        "2017-07-14T16:53:42Z"
+                      ]
+                    },
+                    "updated_at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "examples": [
+                        "2017-08-17T12:37:15Z"
+                      ]
+                    },
+                    "organization": {
+                      "title": "Team Organization",
+                      "description": "Team Organization",
+                      "type": "object",
+                      "properties": {
+                        "login": {
+                          "type": "string",
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "id": {
+                          "type": "integer",
+                          "examples": [
+                            1
+                          ]
+                        },
+                        "node_id": {
+                          "type": "string",
+                          "examples": [
+                            "MDEyOk9yZ2FuaXphdGlvbjE="
+                          ]
+                        },
+                        "url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github"
+                          ]
+                        },
+                        "repos_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github/repos"
+                          ]
+                        },
+                        "events_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github/events"
+                          ]
+                        },
+                        "hooks_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/hooks"
+                          ]
+                        },
+                        "issues_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/issues"
+                          ]
+                        },
+                        "members_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/members{/member}"
+                          ]
+                        },
+                        "public_members_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/public_members{/member}"
+                          ]
+                        },
+                        "avatar_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://github.com/images/error/octocat_happy.gif"
+                          ]
+                        },
+                        "description": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "examples": [
+                            "A great organization"
+                          ]
+                        },
+                        "name": {
+                          "type": "string",
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "company": {
+                          "type": "string",
+                          "examples": [
+                            "GitHub"
+                          ]
+                        },
+                        "blog": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://github.com/blog"
+                          ]
+                        },
+                        "location": {
+                          "type": "string",
+                          "examples": [
+                            "San Francisco"
+                          ]
+                        },
+                        "email": {
+                          "type": "string",
+                          "format": "email",
+                          "examples": [
+                            "octocat@github.com"
+                          ]
+                        },
+                        "twitter_username": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "is_verified": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "has_organization_projects": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "has_repository_projects": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "public_repos": {
+                          "type": "integer",
+                          "examples": [
+                            2
+                          ]
+                        },
+                        "public_gists": {
+                          "type": "integer",
+                          "examples": [
+                            1
+                          ]
+                        },
+                        "followers": {
+                          "type": "integer",
+                          "examples": [
+                            20
+                          ]
+                        },
+                        "following": {
+                          "type": "integer",
+                          "examples": [
+                            0
+                          ]
+                        },
+                        "html_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://github.com/octocat"
+                          ]
+                        },
+                        "created_at": {
+                          "type": "string",
+                          "format": "date-time",
+                          "examples": [
+                            "2008-01-14T04:33:35Z"
+                          ]
+                        },
+                        "type": {
+                          "type": "string",
+                          "examples": [
+                            "Organization"
+                          ]
+                        },
+                        "total_private_repos": {
+                          "type": "integer",
+                          "examples": [
+                            100
+                          ]
+                        },
+                        "owned_private_repos": {
+                          "type": "integer",
+                          "examples": [
+                            100
+                          ]
+                        },
+                        "private_gists": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            81
+                          ]
+                        },
+                        "disk_usage": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            10000
+                          ]
+                        },
+                        "collaborators": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            8
+                          ]
+                        },
+                        "billing_email": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "format": "email",
+                          "examples": [
+                            "org@example.com"
+                          ]
+                        },
+                        "plan": {
+                          "type": "object",
+                          "properties": {
+                            "name": {
+                              "type": "string"
+                            },
+                            "space": {
+                              "type": "integer"
+                            },
+                            "private_repos": {
+                              "type": "integer"
+                            },
+                            "filled_seats": {
+                              "type": "integer"
+                            },
+                            "seats": {
+                              "type": "integer"
+                            }
+                          },
+                          "required": [
+                            "name",
+                            "space",
+                            "private_repos"
+                          ]
+                        },
+                        "default_repository_permission": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "members_can_create_repositories": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "two_factor_requirement_enabled": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_allowed_repository_creation_type": {
+                          "type": "string",
+                          "examples": [
+                            "all"
+                          ]
+                        },
+                        "members_can_create_public_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_private_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_internal_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_public_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_private_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_fork_private_repositories": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            false
+                          ]
+                        },
+                        "updated_at": {
+                          "type": "string",
+                          "format": "date-time"
+                        }
+                      },
+                      "required": [
+                        "login",
+                        "url",
+                        "id",
+                        "node_id",
+                        "repos_url",
+                        "events_url",
+                        "hooks_url",
+                        "issues_url",
+                        "members_url",
+                        "public_members_url",
+                        "avatar_url",
+                        "description",
+                        "html_url",
+                        "has_organization_projects",
+                        "has_repository_projects",
+                        "public_repos",
+                        "public_gists",
+                        "followers",
+                        "following",
+                        "type",
+                        "created_at",
+                        "updated_at"
+                      ]
+                    },
+                    "ldap_dn": {
+                      "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                      "type": "string",
+                      "examples": [
+                        "uid=example,ou=users,dc=github,dc=com"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "node_id",
+                    "url",
+                    "members_url",
+                    "name",
+                    "description",
+                    "permission",
+                    "html_url",
+                    "repositories_url",
+                    "slug",
+                    "created_at",
+                    "updated_at",
+                    "members_count",
+                    "repos_count",
+                    "organization"
+                  ]
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "id": 1,
+                      "node_id": "MDQ6VGVhbTE=",
+                      "url": "https://api.github.com/teams/1",
+                      "html_url": "https://github.com/orgs/github/teams/justice-league",
+                      "name": "Justice League",
+                      "slug": "justice-league",
+                      "description": "A great team.",
+                      "privacy": "closed",
+                      "permission": "admin",
+                      "members_url": "https://api.github.com/teams/1/members{/member}",
+                      "repositories_url": "https://api.github.com/teams/1/repos",
+                      "members_count": 3,
+                      "repos_count": 10,
+                      "created_at": "2017-07-14T16:53:42Z",
+                      "updated_at": "2017-08-17T12:37:15Z",
+                      "organization": {
+                        "login": "github",
+                        "id": 1,
+                        "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
+                        "url": "https://api.github.com/orgs/github",
+                        "repos_url": "https://api.github.com/orgs/github/repos",
+                        "events_url": "https://api.github.com/orgs/github/events",
+                        "hooks_url": "https://api.github.com/orgs/github/hooks",
+                        "issues_url": "https://api.github.com/orgs/github/issues",
+                        "members_url": "https://api.github.com/orgs/github/members{/member}",
+                        "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
+                        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+                        "description": "A great organization",
+                        "name": "github",
+                        "company": "GitHub",
+                        "blog": "https://github.com/blog",
+                        "location": "San Francisco",
+                        "email": "octocat@github.com",
+                        "has_organization_projects": true,
+                        "has_repository_projects": true,
+                        "public_repos": 2,
+                        "public_gists": 1,
+                        "followers": 20,
+                        "following": 0,
+                        "html_url": "https://github.com/octocat",
+                        "created_at": "2008-01-14T04:33:35Z",
+                        "updated_at": "2017-08-17T12:37:15Z",
+                        "type": "Organization"
+                      },
+                      "ldap_dn": "uid=asdf,ou=users,dc=github,dc=com"
+                    }
+                  }
+                }
+              }
+            }
+          },
           "201": {
             "description": "Response",
             "content": {
@@ -116250,6 +116922,133 @@
                 }
               }
             }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Validation Error",
+                  "description": "Validation Error",
+                  "type": "object",
+                  "required": [
+                    "message",
+                    "documentation_url"
+                  ],
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "code"
+                        ],
+                        "properties": {
+                          "resource": {
+                            "type": "string"
+                          },
+                          "field": {
+                            "type": "string"
+                          },
+                          "message": {
+                            "type": "string"
+                          },
+                          "code": {
+                            "type": "string"
+                          },
+                          "index": {
+                            "type": "integer"
+                          },
+                          "value": {
+                            "oneOf": [
+                              {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              {
+                                "type": [
+                                  "integer",
+                                  "null"
+                                ]
+                              },
+                              {
+                                "type": [
+                                  "array",
+                                  "null"
+                                ],
+                                "items": {
+                                  "type": "string"
+                                }
+                              }
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           }
         },
         "x-github": {
@@ -239995,6 +240794,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"
             }
diff --git a/lib/rest/static/dereferenced/ghes-3.5.deref.json b/lib/rest/static/dereferenced/ghes-3.5.deref.json
index 9c3461357f..522833469a 100644
--- a/lib/rest/static/dereferenced/ghes-3.5.deref.json
+++ b/lib/rest/static/dereferenced/ghes-3.5.deref.json
@@ -117949,6 +117949,678 @@
           }
         },
         "responses": {
+          "200": {
+            "description": "Response when the updated information already exists",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Full Team",
+                  "description": "Groups of organization members that gives permissions on specified repositories.",
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "description": "Unique identifier of the team",
+                      "type": "integer",
+                      "examples": [
+                        42
+                      ]
+                    },
+                    "node_id": {
+                      "type": "string",
+                      "examples": [
+                        "MDQ6VGVhbTE="
+                      ]
+                    },
+                    "url": {
+                      "description": "URL for the team",
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1"
+                      ]
+                    },
+                    "html_url": {
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://github.com/orgs/rails/teams/core"
+                      ]
+                    },
+                    "name": {
+                      "description": "Name of the team",
+                      "type": "string",
+                      "examples": [
+                        "Developers"
+                      ]
+                    },
+                    "slug": {
+                      "type": "string",
+                      "examples": [
+                        "justice-league"
+                      ]
+                    },
+                    "description": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "examples": [
+                        "A great team."
+                      ]
+                    },
+                    "privacy": {
+                      "description": "The level of privacy this team should have",
+                      "type": "string",
+                      "enum": [
+                        "closed",
+                        "secret"
+                      ],
+                      "examples": [
+                        "closed"
+                      ]
+                    },
+                    "permission": {
+                      "description": "Permission that the team will have for its repositories",
+                      "type": "string",
+                      "examples": [
+                        "push"
+                      ]
+                    },
+                    "members_url": {
+                      "type": "string",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1/members{/member}"
+                      ]
+                    },
+                    "repositories_url": {
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1/repos"
+                      ]
+                    },
+                    "parent": {
+                      "anyOf": [
+                        {
+                          "type": "null"
+                        },
+                        {
+                          "title": "Team Simple",
+                          "description": "Groups of organization members that gives permissions on specified repositories.",
+                          "type": "object",
+                          "properties": {
+                            "id": {
+                              "description": "Unique identifier of the team",
+                              "type": "integer",
+                              "examples": [
+                                1
+                              ]
+                            },
+                            "node_id": {
+                              "type": "string",
+                              "examples": [
+                                "MDQ6VGVhbTE="
+                              ]
+                            },
+                            "url": {
+                              "description": "URL for the team",
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1"
+                              ]
+                            },
+                            "members_url": {
+                              "type": "string",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1/members{/member}"
+                              ]
+                            },
+                            "name": {
+                              "description": "Name of the team",
+                              "type": "string",
+                              "examples": [
+                                "Justice League"
+                              ]
+                            },
+                            "description": {
+                              "description": "Description of the team",
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "examples": [
+                                "A great team."
+                              ]
+                            },
+                            "permission": {
+                              "description": "Permission that the team will have for its repositories",
+                              "type": "string",
+                              "examples": [
+                                "admin"
+                              ]
+                            },
+                            "privacy": {
+                              "description": "The level of privacy this team should have",
+                              "type": "string",
+                              "examples": [
+                                "closed"
+                              ]
+                            },
+                            "html_url": {
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://github.com/orgs/rails/teams/core"
+                              ]
+                            },
+                            "repositories_url": {
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1/repos"
+                              ]
+                            },
+                            "slug": {
+                              "type": "string",
+                              "examples": [
+                                "justice-league"
+                              ]
+                            },
+                            "ldap_dn": {
+                              "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                              "type": "string",
+                              "examples": [
+                                "uid=example,ou=users,dc=github,dc=com"
+                              ]
+                            }
+                          },
+                          "required": [
+                            "id",
+                            "node_id",
+                            "url",
+                            "members_url",
+                            "name",
+                            "description",
+                            "permission",
+                            "html_url",
+                            "repositories_url",
+                            "slug"
+                          ]
+                        }
+                      ]
+                    },
+                    "members_count": {
+                      "type": "integer",
+                      "examples": [
+                        3
+                      ]
+                    },
+                    "repos_count": {
+                      "type": "integer",
+                      "examples": [
+                        10
+                      ]
+                    },
+                    "created_at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "examples": [
+                        "2017-07-14T16:53:42Z"
+                      ]
+                    },
+                    "updated_at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "examples": [
+                        "2017-08-17T12:37:15Z"
+                      ]
+                    },
+                    "organization": {
+                      "title": "Team Organization",
+                      "description": "Team Organization",
+                      "type": "object",
+                      "properties": {
+                        "login": {
+                          "type": "string",
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "id": {
+                          "type": "integer",
+                          "examples": [
+                            1
+                          ]
+                        },
+                        "node_id": {
+                          "type": "string",
+                          "examples": [
+                            "MDEyOk9yZ2FuaXphdGlvbjE="
+                          ]
+                        },
+                        "url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github"
+                          ]
+                        },
+                        "repos_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github/repos"
+                          ]
+                        },
+                        "events_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github/events"
+                          ]
+                        },
+                        "hooks_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/hooks"
+                          ]
+                        },
+                        "issues_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/issues"
+                          ]
+                        },
+                        "members_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/members{/member}"
+                          ]
+                        },
+                        "public_members_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/public_members{/member}"
+                          ]
+                        },
+                        "avatar_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://github.com/images/error/octocat_happy.gif"
+                          ]
+                        },
+                        "description": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "examples": [
+                            "A great organization"
+                          ]
+                        },
+                        "name": {
+                          "type": "string",
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "company": {
+                          "type": "string",
+                          "examples": [
+                            "GitHub"
+                          ]
+                        },
+                        "blog": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://github.com/blog"
+                          ]
+                        },
+                        "location": {
+                          "type": "string",
+                          "examples": [
+                            "San Francisco"
+                          ]
+                        },
+                        "email": {
+                          "type": "string",
+                          "format": "email",
+                          "examples": [
+                            "octocat@github.com"
+                          ]
+                        },
+                        "twitter_username": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "is_verified": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "has_organization_projects": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "has_repository_projects": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "public_repos": {
+                          "type": "integer",
+                          "examples": [
+                            2
+                          ]
+                        },
+                        "public_gists": {
+                          "type": "integer",
+                          "examples": [
+                            1
+                          ]
+                        },
+                        "followers": {
+                          "type": "integer",
+                          "examples": [
+                            20
+                          ]
+                        },
+                        "following": {
+                          "type": "integer",
+                          "examples": [
+                            0
+                          ]
+                        },
+                        "html_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://github.com/octocat"
+                          ]
+                        },
+                        "created_at": {
+                          "type": "string",
+                          "format": "date-time",
+                          "examples": [
+                            "2008-01-14T04:33:35Z"
+                          ]
+                        },
+                        "type": {
+                          "type": "string",
+                          "examples": [
+                            "Organization"
+                          ]
+                        },
+                        "total_private_repos": {
+                          "type": "integer",
+                          "examples": [
+                            100
+                          ]
+                        },
+                        "owned_private_repos": {
+                          "type": "integer",
+                          "examples": [
+                            100
+                          ]
+                        },
+                        "private_gists": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            81
+                          ]
+                        },
+                        "disk_usage": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            10000
+                          ]
+                        },
+                        "collaborators": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            8
+                          ]
+                        },
+                        "billing_email": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "format": "email",
+                          "examples": [
+                            "org@example.com"
+                          ]
+                        },
+                        "plan": {
+                          "type": "object",
+                          "properties": {
+                            "name": {
+                              "type": "string"
+                            },
+                            "space": {
+                              "type": "integer"
+                            },
+                            "private_repos": {
+                              "type": "integer"
+                            },
+                            "filled_seats": {
+                              "type": "integer"
+                            },
+                            "seats": {
+                              "type": "integer"
+                            }
+                          },
+                          "required": [
+                            "name",
+                            "space",
+                            "private_repos"
+                          ]
+                        },
+                        "default_repository_permission": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "members_can_create_repositories": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "two_factor_requirement_enabled": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_allowed_repository_creation_type": {
+                          "type": "string",
+                          "examples": [
+                            "all"
+                          ]
+                        },
+                        "members_can_create_public_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_private_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_internal_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_public_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_private_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_fork_private_repositories": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            false
+                          ]
+                        },
+                        "updated_at": {
+                          "type": "string",
+                          "format": "date-time"
+                        }
+                      },
+                      "required": [
+                        "login",
+                        "url",
+                        "id",
+                        "node_id",
+                        "repos_url",
+                        "events_url",
+                        "hooks_url",
+                        "issues_url",
+                        "members_url",
+                        "public_members_url",
+                        "avatar_url",
+                        "description",
+                        "html_url",
+                        "has_organization_projects",
+                        "has_repository_projects",
+                        "public_repos",
+                        "public_gists",
+                        "followers",
+                        "following",
+                        "type",
+                        "created_at",
+                        "updated_at"
+                      ]
+                    },
+                    "ldap_dn": {
+                      "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                      "type": "string",
+                      "examples": [
+                        "uid=example,ou=users,dc=github,dc=com"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "node_id",
+                    "url",
+                    "members_url",
+                    "name",
+                    "description",
+                    "permission",
+                    "html_url",
+                    "repositories_url",
+                    "slug",
+                    "created_at",
+                    "updated_at",
+                    "members_count",
+                    "repos_count",
+                    "organization"
+                  ]
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "id": 1,
+                      "node_id": "MDQ6VGVhbTE=",
+                      "url": "https://api.github.com/teams/1",
+                      "html_url": "https://github.com/orgs/github/teams/justice-league",
+                      "name": "Justice League",
+                      "slug": "justice-league",
+                      "description": "A great team.",
+                      "privacy": "closed",
+                      "permission": "admin",
+                      "members_url": "https://api.github.com/teams/1/members{/member}",
+                      "repositories_url": "https://api.github.com/teams/1/repos",
+                      "members_count": 3,
+                      "repos_count": 10,
+                      "created_at": "2017-07-14T16:53:42Z",
+                      "updated_at": "2017-08-17T12:37:15Z",
+                      "organization": {
+                        "login": "github",
+                        "id": 1,
+                        "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
+                        "url": "https://api.github.com/orgs/github",
+                        "repos_url": "https://api.github.com/orgs/github/repos",
+                        "events_url": "https://api.github.com/orgs/github/events",
+                        "hooks_url": "https://api.github.com/orgs/github/hooks",
+                        "issues_url": "https://api.github.com/orgs/github/issues",
+                        "members_url": "https://api.github.com/orgs/github/members{/member}",
+                        "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
+                        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+                        "description": "A great organization",
+                        "name": "github",
+                        "company": "GitHub",
+                        "blog": "https://github.com/blog",
+                        "location": "San Francisco",
+                        "email": "octocat@github.com",
+                        "has_organization_projects": true,
+                        "has_repository_projects": true,
+                        "public_repos": 2,
+                        "public_gists": 1,
+                        "followers": 20,
+                        "following": 0,
+                        "html_url": "https://github.com/octocat",
+                        "created_at": "2008-01-14T04:33:35Z",
+                        "updated_at": "2017-08-17T12:37:15Z",
+                        "type": "Organization"
+                      },
+                      "ldap_dn": "uid=asdf,ou=users,dc=github,dc=com"
+                    }
+                  }
+                }
+              }
+            }
+          },
           "201": {
             "description": "Response",
             "content": {
@@ -118620,6 +119292,133 @@
                 }
               }
             }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Validation Error",
+                  "description": "Validation Error",
+                  "type": "object",
+                  "required": [
+                    "message",
+                    "documentation_url"
+                  ],
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "code"
+                        ],
+                        "properties": {
+                          "resource": {
+                            "type": "string"
+                          },
+                          "field": {
+                            "type": "string"
+                          },
+                          "message": {
+                            "type": "string"
+                          },
+                          "code": {
+                            "type": "string"
+                          },
+                          "index": {
+                            "type": "integer"
+                          },
+                          "value": {
+                            "oneOf": [
+                              {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              {
+                                "type": [
+                                  "integer",
+                                  "null"
+                                ]
+                              },
+                              {
+                                "type": [
+                                  "array",
+                                  "null"
+                                ],
+                                "items": {
+                                  "type": "string"
+                                }
+                              }
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           }
         },
         "x-github": {
@@ -250135,6 +250934,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"
             }
diff --git a/lib/rest/static/dereferenced/ghes-3.6.deref.json b/lib/rest/static/dereferenced/ghes-3.6.deref.json
index 7ebf1ba6ec..4c1b6ded6e 100644
--- a/lib/rest/static/dereferenced/ghes-3.6.deref.json
+++ b/lib/rest/static/dereferenced/ghes-3.6.deref.json
@@ -120456,6 +120456,684 @@
           }
         },
         "responses": {
+          "200": {
+            "description": "Response when the updated information already exists",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Full Team",
+                  "description": "Groups of organization members that gives permissions on specified repositories.",
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "description": "Unique identifier of the team",
+                      "type": "integer",
+                      "examples": [
+                        42
+                      ]
+                    },
+                    "node_id": {
+                      "type": "string",
+                      "examples": [
+                        "MDQ6VGVhbTE="
+                      ]
+                    },
+                    "url": {
+                      "description": "URL for the team",
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1"
+                      ]
+                    },
+                    "html_url": {
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://github.com/orgs/rails/teams/core"
+                      ]
+                    },
+                    "name": {
+                      "description": "Name of the team",
+                      "type": "string",
+                      "examples": [
+                        "Developers"
+                      ]
+                    },
+                    "slug": {
+                      "type": "string",
+                      "examples": [
+                        "justice-league"
+                      ]
+                    },
+                    "description": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "examples": [
+                        "A great team."
+                      ]
+                    },
+                    "privacy": {
+                      "description": "The level of privacy this team should have",
+                      "type": "string",
+                      "enum": [
+                        "closed",
+                        "secret"
+                      ],
+                      "examples": [
+                        "closed"
+                      ]
+                    },
+                    "permission": {
+                      "description": "Permission that the team will have for its repositories",
+                      "type": "string",
+                      "examples": [
+                        "push"
+                      ]
+                    },
+                    "members_url": {
+                      "type": "string",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1/members{/member}"
+                      ]
+                    },
+                    "repositories_url": {
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1/repos"
+                      ]
+                    },
+                    "parent": {
+                      "anyOf": [
+                        {
+                          "type": "null"
+                        },
+                        {
+                          "title": "Team Simple",
+                          "description": "Groups of organization members that gives permissions on specified repositories.",
+                          "type": "object",
+                          "properties": {
+                            "id": {
+                              "description": "Unique identifier of the team",
+                              "type": "integer",
+                              "examples": [
+                                1
+                              ]
+                            },
+                            "node_id": {
+                              "type": "string",
+                              "examples": [
+                                "MDQ6VGVhbTE="
+                              ]
+                            },
+                            "url": {
+                              "description": "URL for the team",
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1"
+                              ]
+                            },
+                            "members_url": {
+                              "type": "string",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1/members{/member}"
+                              ]
+                            },
+                            "name": {
+                              "description": "Name of the team",
+                              "type": "string",
+                              "examples": [
+                                "Justice League"
+                              ]
+                            },
+                            "description": {
+                              "description": "Description of the team",
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "examples": [
+                                "A great team."
+                              ]
+                            },
+                            "permission": {
+                              "description": "Permission that the team will have for its repositories",
+                              "type": "string",
+                              "examples": [
+                                "admin"
+                              ]
+                            },
+                            "privacy": {
+                              "description": "The level of privacy this team should have",
+                              "type": "string",
+                              "examples": [
+                                "closed"
+                              ]
+                            },
+                            "html_url": {
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://github.com/orgs/rails/teams/core"
+                              ]
+                            },
+                            "repositories_url": {
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1/repos"
+                              ]
+                            },
+                            "slug": {
+                              "type": "string",
+                              "examples": [
+                                "justice-league"
+                              ]
+                            },
+                            "ldap_dn": {
+                              "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                              "type": "string",
+                              "examples": [
+                                "uid=example,ou=users,dc=github,dc=com"
+                              ]
+                            }
+                          },
+                          "required": [
+                            "id",
+                            "node_id",
+                            "url",
+                            "members_url",
+                            "name",
+                            "description",
+                            "permission",
+                            "html_url",
+                            "repositories_url",
+                            "slug"
+                          ]
+                        }
+                      ]
+                    },
+                    "members_count": {
+                      "type": "integer",
+                      "examples": [
+                        3
+                      ]
+                    },
+                    "repos_count": {
+                      "type": "integer",
+                      "examples": [
+                        10
+                      ]
+                    },
+                    "created_at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "examples": [
+                        "2017-07-14T16:53:42Z"
+                      ]
+                    },
+                    "updated_at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "examples": [
+                        "2017-08-17T12:37:15Z"
+                      ]
+                    },
+                    "organization": {
+                      "title": "Team Organization",
+                      "description": "Team Organization",
+                      "type": "object",
+                      "properties": {
+                        "login": {
+                          "type": "string",
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "id": {
+                          "type": "integer",
+                          "examples": [
+                            1
+                          ]
+                        },
+                        "node_id": {
+                          "type": "string",
+                          "examples": [
+                            "MDEyOk9yZ2FuaXphdGlvbjE="
+                          ]
+                        },
+                        "url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github"
+                          ]
+                        },
+                        "repos_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github/repos"
+                          ]
+                        },
+                        "events_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github/events"
+                          ]
+                        },
+                        "hooks_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/hooks"
+                          ]
+                        },
+                        "issues_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/issues"
+                          ]
+                        },
+                        "members_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/members{/member}"
+                          ]
+                        },
+                        "public_members_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/public_members{/member}"
+                          ]
+                        },
+                        "avatar_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://github.com/images/error/octocat_happy.gif"
+                          ]
+                        },
+                        "description": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "examples": [
+                            "A great organization"
+                          ]
+                        },
+                        "name": {
+                          "type": "string",
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "company": {
+                          "type": "string",
+                          "examples": [
+                            "GitHub"
+                          ]
+                        },
+                        "blog": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://github.com/blog"
+                          ]
+                        },
+                        "location": {
+                          "type": "string",
+                          "examples": [
+                            "San Francisco"
+                          ]
+                        },
+                        "email": {
+                          "type": "string",
+                          "format": "email",
+                          "examples": [
+                            "octocat@github.com"
+                          ]
+                        },
+                        "twitter_username": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "is_verified": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "has_organization_projects": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "has_repository_projects": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "public_repos": {
+                          "type": "integer",
+                          "examples": [
+                            2
+                          ]
+                        },
+                        "public_gists": {
+                          "type": "integer",
+                          "examples": [
+                            1
+                          ]
+                        },
+                        "followers": {
+                          "type": "integer",
+                          "examples": [
+                            20
+                          ]
+                        },
+                        "following": {
+                          "type": "integer",
+                          "examples": [
+                            0
+                          ]
+                        },
+                        "html_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://github.com/octocat"
+                          ]
+                        },
+                        "created_at": {
+                          "type": "string",
+                          "format": "date-time",
+                          "examples": [
+                            "2008-01-14T04:33:35Z"
+                          ]
+                        },
+                        "type": {
+                          "type": "string",
+                          "examples": [
+                            "Organization"
+                          ]
+                        },
+                        "total_private_repos": {
+                          "type": "integer",
+                          "examples": [
+                            100
+                          ]
+                        },
+                        "owned_private_repos": {
+                          "type": "integer",
+                          "examples": [
+                            100
+                          ]
+                        },
+                        "private_gists": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            81
+                          ]
+                        },
+                        "disk_usage": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            10000
+                          ]
+                        },
+                        "collaborators": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            8
+                          ]
+                        },
+                        "billing_email": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "format": "email",
+                          "examples": [
+                            "org@example.com"
+                          ]
+                        },
+                        "plan": {
+                          "type": "object",
+                          "properties": {
+                            "name": {
+                              "type": "string"
+                            },
+                            "space": {
+                              "type": "integer"
+                            },
+                            "private_repos": {
+                              "type": "integer"
+                            },
+                            "filled_seats": {
+                              "type": "integer"
+                            },
+                            "seats": {
+                              "type": "integer"
+                            }
+                          },
+                          "required": [
+                            "name",
+                            "space",
+                            "private_repos"
+                          ]
+                        },
+                        "default_repository_permission": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "members_can_create_repositories": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "two_factor_requirement_enabled": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_allowed_repository_creation_type": {
+                          "type": "string",
+                          "examples": [
+                            "all"
+                          ]
+                        },
+                        "members_can_create_public_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_private_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_internal_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_public_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_private_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_fork_private_repositories": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            false
+                          ]
+                        },
+                        "web_commit_signoff_required": {
+                          "type": "boolean",
+                          "examples": [
+                            false
+                          ]
+                        },
+                        "updated_at": {
+                          "type": "string",
+                          "format": "date-time"
+                        }
+                      },
+                      "required": [
+                        "login",
+                        "url",
+                        "id",
+                        "node_id",
+                        "repos_url",
+                        "events_url",
+                        "hooks_url",
+                        "issues_url",
+                        "members_url",
+                        "public_members_url",
+                        "avatar_url",
+                        "description",
+                        "html_url",
+                        "has_organization_projects",
+                        "has_repository_projects",
+                        "public_repos",
+                        "public_gists",
+                        "followers",
+                        "following",
+                        "type",
+                        "created_at",
+                        "updated_at"
+                      ]
+                    },
+                    "ldap_dn": {
+                      "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                      "type": "string",
+                      "examples": [
+                        "uid=example,ou=users,dc=github,dc=com"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "node_id",
+                    "url",
+                    "members_url",
+                    "name",
+                    "description",
+                    "permission",
+                    "html_url",
+                    "repositories_url",
+                    "slug",
+                    "created_at",
+                    "updated_at",
+                    "members_count",
+                    "repos_count",
+                    "organization"
+                  ]
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "id": 1,
+                      "node_id": "MDQ6VGVhbTE=",
+                      "url": "https://api.github.com/teams/1",
+                      "html_url": "https://github.com/orgs/github/teams/justice-league",
+                      "name": "Justice League",
+                      "slug": "justice-league",
+                      "description": "A great team.",
+                      "privacy": "closed",
+                      "permission": "admin",
+                      "members_url": "https://api.github.com/teams/1/members{/member}",
+                      "repositories_url": "https://api.github.com/teams/1/repos",
+                      "members_count": 3,
+                      "repos_count": 10,
+                      "created_at": "2017-07-14T16:53:42Z",
+                      "updated_at": "2017-08-17T12:37:15Z",
+                      "organization": {
+                        "login": "github",
+                        "id": 1,
+                        "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
+                        "url": "https://api.github.com/orgs/github",
+                        "repos_url": "https://api.github.com/orgs/github/repos",
+                        "events_url": "https://api.github.com/orgs/github/events",
+                        "hooks_url": "https://api.github.com/orgs/github/hooks",
+                        "issues_url": "https://api.github.com/orgs/github/issues",
+                        "members_url": "https://api.github.com/orgs/github/members{/member}",
+                        "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
+                        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+                        "description": "A great organization",
+                        "name": "github",
+                        "company": "GitHub",
+                        "blog": "https://github.com/blog",
+                        "location": "San Francisco",
+                        "email": "octocat@github.com",
+                        "has_organization_projects": true,
+                        "has_repository_projects": true,
+                        "public_repos": 2,
+                        "public_gists": 1,
+                        "followers": 20,
+                        "following": 0,
+                        "html_url": "https://github.com/octocat",
+                        "created_at": "2008-01-14T04:33:35Z",
+                        "updated_at": "2017-08-17T12:37:15Z",
+                        "type": "Organization"
+                      },
+                      "ldap_dn": "uid=asdf,ou=users,dc=github,dc=com"
+                    }
+                  }
+                }
+              }
+            }
+          },
           "201": {
             "description": "Response",
             "content": {
@@ -121133,6 +121811,133 @@
                 }
               }
             }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Validation Error",
+                  "description": "Validation Error",
+                  "type": "object",
+                  "required": [
+                    "message",
+                    "documentation_url"
+                  ],
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "code"
+                        ],
+                        "properties": {
+                          "resource": {
+                            "type": "string"
+                          },
+                          "field": {
+                            "type": "string"
+                          },
+                          "message": {
+                            "type": "string"
+                          },
+                          "code": {
+                            "type": "string"
+                          },
+                          "index": {
+                            "type": "integer"
+                          },
+                          "value": {
+                            "oneOf": [
+                              {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              {
+                                "type": [
+                                  "integer",
+                                  "null"
+                                ]
+                              },
+                              {
+                                "type": [
+                                  "array",
+                                  "null"
+                                ],
+                                "items": {
+                                  "type": "string"
+                                }
+                              }
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           }
         },
         "x-github": {
@@ -255507,6 +256312,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"
             }
diff --git a/lib/rest/static/dereferenced/github.ae.deref.json b/lib/rest/static/dereferenced/github.ae.deref.json
index 9e241874e8..58e0a19f7f 100644
--- a/lib/rest/static/dereferenced/github.ae.deref.json
+++ b/lib/rest/static/dereferenced/github.ae.deref.json
@@ -81999,6 +81999,685 @@
           }
         },
         "responses": {
+          "200": {
+            "description": "Response when the updated information already exists",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Full Team",
+                  "description": "Groups of organization members that gives permissions on specified repositories.",
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "description": "Unique identifier of the team",
+                      "type": "integer",
+                      "examples": [
+                        42
+                      ]
+                    },
+                    "node_id": {
+                      "type": "string",
+                      "examples": [
+                        "MDQ6VGVhbTE="
+                      ]
+                    },
+                    "url": {
+                      "description": "URL for the team",
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1"
+                      ]
+                    },
+                    "html_url": {
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://github.com/orgs/rails/teams/core"
+                      ]
+                    },
+                    "name": {
+                      "description": "Name of the team",
+                      "type": "string",
+                      "examples": [
+                        "Developers"
+                      ]
+                    },
+                    "slug": {
+                      "type": "string",
+                      "examples": [
+                        "justice-league"
+                      ]
+                    },
+                    "description": {
+                      "type": [
+                        "string",
+                        "null"
+                      ],
+                      "examples": [
+                        "A great team."
+                      ]
+                    },
+                    "privacy": {
+                      "description": "The level of privacy this team should have",
+                      "type": "string",
+                      "enum": [
+                        "closed",
+                        "secret"
+                      ],
+                      "examples": [
+                        "closed"
+                      ]
+                    },
+                    "permission": {
+                      "description": "Permission that the team will have for its repositories",
+                      "type": "string",
+                      "examples": [
+                        "push"
+                      ]
+                    },
+                    "members_url": {
+                      "type": "string",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1/members{/member}"
+                      ]
+                    },
+                    "repositories_url": {
+                      "type": "string",
+                      "format": "uri",
+                      "examples": [
+                        "https://api.github.com/organizations/1/team/1/repos"
+                      ]
+                    },
+                    "parent": {
+                      "anyOf": [
+                        {
+                          "type": "null"
+                        },
+                        {
+                          "title": "Team Simple",
+                          "description": "Groups of organization members that gives permissions on specified repositories.",
+                          "type": "object",
+                          "properties": {
+                            "id": {
+                              "description": "Unique identifier of the team",
+                              "type": "integer",
+                              "examples": [
+                                1
+                              ]
+                            },
+                            "node_id": {
+                              "type": "string",
+                              "examples": [
+                                "MDQ6VGVhbTE="
+                              ]
+                            },
+                            "url": {
+                              "description": "URL for the team",
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1"
+                              ]
+                            },
+                            "members_url": {
+                              "type": "string",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1/members{/member}"
+                              ]
+                            },
+                            "name": {
+                              "description": "Name of the team",
+                              "type": "string",
+                              "examples": [
+                                "Justice League"
+                              ]
+                            },
+                            "description": {
+                              "description": "Description of the team",
+                              "type": [
+                                "string",
+                                "null"
+                              ],
+                              "examples": [
+                                "A great team."
+                              ]
+                            },
+                            "permission": {
+                              "description": "Permission that the team will have for its repositories",
+                              "type": "string",
+                              "examples": [
+                                "admin"
+                              ]
+                            },
+                            "privacy": {
+                              "description": "The level of privacy this team should have",
+                              "type": "string",
+                              "examples": [
+                                "closed"
+                              ]
+                            },
+                            "html_url": {
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://github.com/orgs/rails/teams/core"
+                              ]
+                            },
+                            "repositories_url": {
+                              "type": "string",
+                              "format": "uri",
+                              "examples": [
+                                "https://api.github.com/organizations/1/team/1/repos"
+                              ]
+                            },
+                            "slug": {
+                              "type": "string",
+                              "examples": [
+                                "justice-league"
+                              ]
+                            },
+                            "ldap_dn": {
+                              "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                              "type": "string",
+                              "examples": [
+                                "uid=example,ou=users,dc=github,dc=com"
+                              ]
+                            }
+                          },
+                          "required": [
+                            "id",
+                            "node_id",
+                            "url",
+                            "members_url",
+                            "name",
+                            "description",
+                            "permission",
+                            "html_url",
+                            "repositories_url",
+                            "slug"
+                          ]
+                        }
+                      ]
+                    },
+                    "members_count": {
+                      "type": "integer",
+                      "examples": [
+                        3
+                      ]
+                    },
+                    "repos_count": {
+                      "type": "integer",
+                      "examples": [
+                        10
+                      ]
+                    },
+                    "created_at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "examples": [
+                        "2017-07-14T16:53:42Z"
+                      ]
+                    },
+                    "updated_at": {
+                      "type": "string",
+                      "format": "date-time",
+                      "examples": [
+                        "2017-08-17T12:37:15Z"
+                      ]
+                    },
+                    "organization": {
+                      "title": "Team Organization",
+                      "description": "Team Organization",
+                      "type": "object",
+                      "properties": {
+                        "login": {
+                          "type": "string",
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "id": {
+                          "type": "integer",
+                          "examples": [
+                            1
+                          ]
+                        },
+                        "node_id": {
+                          "type": "string",
+                          "examples": [
+                            "MDEyOk9yZ2FuaXphdGlvbjE="
+                          ]
+                        },
+                        "url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github"
+                          ]
+                        },
+                        "repos_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github/repos"
+                          ]
+                        },
+                        "events_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://api.github.com/orgs/github/events"
+                          ]
+                        },
+                        "hooks_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/hooks"
+                          ]
+                        },
+                        "issues_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/issues"
+                          ]
+                        },
+                        "members_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/members{/member}"
+                          ]
+                        },
+                        "public_members_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://api.github.com/orgs/github/public_members{/member}"
+                          ]
+                        },
+                        "avatar_url": {
+                          "type": "string",
+                          "examples": [
+                            "https://github.com/images/error/octocat_happy.gif"
+                          ]
+                        },
+                        "description": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "examples": [
+                            "A great organization"
+                          ]
+                        },
+                        "name": {
+                          "type": "string",
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "company": {
+                          "type": "string",
+                          "examples": [
+                            "GitHub"
+                          ]
+                        },
+                        "blog": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://github.com/blog"
+                          ]
+                        },
+                        "location": {
+                          "type": "string",
+                          "examples": [
+                            "San Francisco"
+                          ]
+                        },
+                        "email": {
+                          "type": "string",
+                          "format": "email",
+                          "examples": [
+                            "octocat@github.com"
+                          ]
+                        },
+                        "twitter_username": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "examples": [
+                            "github"
+                          ]
+                        },
+                        "is_verified": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "has_organization_projects": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "has_repository_projects": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "public_repos": {
+                          "type": "integer",
+                          "examples": [
+                            2
+                          ]
+                        },
+                        "public_gists": {
+                          "type": "integer",
+                          "examples": [
+                            1
+                          ]
+                        },
+                        "followers": {
+                          "type": "integer",
+                          "examples": [
+                            20
+                          ]
+                        },
+                        "following": {
+                          "type": "integer",
+                          "examples": [
+                            0
+                          ]
+                        },
+                        "html_url": {
+                          "type": "string",
+                          "format": "uri",
+                          "examples": [
+                            "https://github.com/octocat"
+                          ]
+                        },
+                        "created_at": {
+                          "type": "string",
+                          "format": "date-time",
+                          "examples": [
+                            "2008-01-14T04:33:35Z"
+                          ]
+                        },
+                        "type": {
+                          "type": "string",
+                          "examples": [
+                            "Organization"
+                          ]
+                        },
+                        "total_private_repos": {
+                          "type": "integer",
+                          "examples": [
+                            100
+                          ]
+                        },
+                        "owned_private_repos": {
+                          "type": "integer",
+                          "examples": [
+                            100
+                          ]
+                        },
+                        "private_gists": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            81
+                          ]
+                        },
+                        "disk_usage": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            10000
+                          ]
+                        },
+                        "collaborators": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ],
+                          "examples": [
+                            8
+                          ]
+                        },
+                        "billing_email": {
+                          "type": [
+                            "string",
+                            "null"
+                          ],
+                          "format": "email",
+                          "examples": [
+                            "org@example.com"
+                          ]
+                        },
+                        "plan": {
+                          "type": "object",
+                          "properties": {
+                            "name": {
+                              "type": "string"
+                            },
+                            "space": {
+                              "type": "integer"
+                            },
+                            "private_repos": {
+                              "type": "integer"
+                            },
+                            "filled_seats": {
+                              "type": "integer"
+                            },
+                            "seats": {
+                              "type": "integer"
+                            }
+                          },
+                          "required": [
+                            "name",
+                            "space",
+                            "private_repos"
+                          ]
+                        },
+                        "default_repository_permission": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "members_can_create_repositories": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "two_factor_requirement_enabled": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_allowed_repository_creation_type": {
+                          "type": "string",
+                          "examples": [
+                            "all"
+                          ]
+                        },
+                        "members_can_create_public_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_private_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_internal_repositories": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_public_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_create_private_pages": {
+                          "type": "boolean",
+                          "examples": [
+                            true
+                          ]
+                        },
+                        "members_can_fork_private_repositories": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ],
+                          "examples": [
+                            false
+                          ]
+                        },
+                        "web_commit_signoff_required": {
+                          "type": "boolean",
+                          "examples": [
+                            false
+                          ]
+                        },
+                        "updated_at": {
+                          "type": "string",
+                          "format": "date-time"
+                        }
+                      },
+                      "required": [
+                        "login",
+                        "url",
+                        "id",
+                        "node_id",
+                        "repos_url",
+                        "events_url",
+                        "hooks_url",
+                        "issues_url",
+                        "members_url",
+                        "public_members_url",
+                        "avatar_url",
+                        "description",
+                        "html_url",
+                        "has_organization_projects",
+                        "has_repository_projects",
+                        "public_repos",
+                        "public_gists",
+                        "followers",
+                        "following",
+                        "type",
+                        "created_at",
+                        "updated_at"
+                      ]
+                    },
+                    "ldap_dn": {
+                      "description": "Distinguished Name (DN) that team maps to within LDAP environment",
+                      "type": "string",
+                      "examples": [
+                        "uid=example,ou=users,dc=github,dc=com"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "node_id",
+                    "url",
+                    "members_url",
+                    "name",
+                    "description",
+                    "permission",
+                    "html_url",
+                    "repositories_url",
+                    "slug",
+                    "created_at",
+                    "updated_at",
+                    "members_count",
+                    "repos_count",
+                    "organization"
+                  ]
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "id": 1,
+                      "node_id": "MDQ6VGVhbTE=",
+                      "url": "https://api.github.com/teams/1",
+                      "html_url": "https://github.com/orgs/github/teams/justice-league",
+                      "name": "Justice League",
+                      "slug": "justice-league",
+                      "description": "A great team.",
+                      "privacy": "closed",
+                      "permission": "admin",
+                      "members_url": "https://api.github.com/teams/1/members{/member}",
+                      "repositories_url": "https://api.github.com/teams/1/repos",
+                      "parent": null,
+                      "members_count": 3,
+                      "repos_count": 10,
+                      "created_at": "2017-07-14T16:53:42Z",
+                      "updated_at": "2017-08-17T12:37:15Z",
+                      "organization": {
+                        "login": "github",
+                        "id": 1,
+                        "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
+                        "url": "https://api.github.com/orgs/github",
+                        "repos_url": "https://api.github.com/orgs/github/repos",
+                        "events_url": "https://api.github.com/orgs/github/events",
+                        "hooks_url": "https://api.github.com/orgs/github/hooks",
+                        "issues_url": "https://api.github.com/orgs/github/issues",
+                        "members_url": "https://api.github.com/orgs/github/members{/member}",
+                        "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
+                        "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+                        "description": "A great organization",
+                        "name": "github",
+                        "company": "GitHub",
+                        "blog": "https://github.com/blog",
+                        "location": "San Francisco",
+                        "email": "octocat@github.com",
+                        "is_verified": true,
+                        "has_organization_projects": true,
+                        "has_repository_projects": true,
+                        "public_repos": 2,
+                        "public_gists": 1,
+                        "followers": 20,
+                        "following": 0,
+                        "html_url": "https://github.com/octocat",
+                        "created_at": "2008-01-14T04:33:35Z",
+                        "updated_at": "2017-08-17T12:37:15Z",
+                        "type": "Organization"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
           "201": {
             "description": "Response",
             "content": {
@@ -82677,6 +83356,133 @@
                 }
               }
             }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Validation Error",
+                  "description": "Validation Error",
+                  "type": "object",
+                  "required": [
+                    "message",
+                    "documentation_url"
+                  ],
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "errors": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "code"
+                        ],
+                        "properties": {
+                          "resource": {
+                            "type": "string"
+                          },
+                          "field": {
+                            "type": "string"
+                          },
+                          "message": {
+                            "type": "string"
+                          },
+                          "code": {
+                            "type": "string"
+                          },
+                          "index": {
+                            "type": "integer"
+                          },
+                          "value": {
+                            "oneOf": [
+                              {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              {
+                                "type": [
+                                  "integer",
+                                  "null"
+                                ]
+                              },
+                              {
+                                "type": [
+                                  "array",
+                                  "null"
+                                ],
+                                "items": {
+                                  "type": "string"
+                                }
+                              }
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
           }
         },
         "x-github": {
@@ -209026,6 +209832,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"
             }