@octokit/openapi 7.12.0 → 7.13.0

package/generated/ghes-3.6.deref.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "7.12.0",
+    "version": "7.13.0",
     "title": "GitHub's official OpenAPI spec + Octokit extension",
     "description": "OpenAPI specs from https://github.com/github/rest-api-description with the 'x-octokit' extension required by the Octokit SDKs",
     "license": {
@@ -33424,7 +33424,7 @@
                         "description": "The REST API URL of the code locations for this alert."
                       },
                       "state": {
-                        "description": "Sets the state of the secret scanning alert. Can be either `open` or `resolved`. You must provide `resolution` when you set the state to `resolved`.",
+                        "description": "Sets the state of the secret scanning alert. You must provide `resolution` when you set the state to `resolved`.",
                         "type": "string",
                         "enum": [
                           "open",
@@ -49720,7 +49720,7 @@
           },
           {
             "name": "state",
-            "description": "Indicates the state of the issues to return. Can be either `open`, `closed`, or `all`.",
+            "description": "Indicates the state of the issues to return.",
             "in": "query",
             "required": false,
             "schema": {
@@ -49744,7 +49744,7 @@
           },
           {
             "name": "sort",
-            "description": "What to sort results by. Can be either `created`, `updated`, `comments`.",
+            "description": "What to sort results by.",
             "in": "query",
             "required": false,
             "schema": {
@@ -53052,7 +53052,7 @@
                     "type": "string"
                   },
                   "mode": {
-                    "description": "The rendering mode. Can be either `markdown` or `gfm`.",
+                    "description": "The rendering mode.",
                     "enum": [
                       "markdown",
                       "gfm"
@@ -82393,6 +82393,339 @@
         "x-octokit": {}
       }
     },
+    "/orgs/{org}/external-group/{group_id}": {
+      "get": {
+        "summary": "Get an external group",
+        "description": "Displays information about the specific group's usage.  Provides a list of the group's external members as well as a list of teams that this group is connected to.\n\nYou can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"[GitHub's products](https://docs.github.com/enterprise-server@3.6/github/getting-started-with-github/githubs-products)\" in the GitHub Help documentation.",
+        "tags": [
+          "teams"
+        ],
+        "operationId": "teams/external-idp-group-info-for-org",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/enterprise-server@3.6/rest/reference/teams#external-idp-group-info-for-an-organization"
+        },
+        "parameters": [
+          {
+            "name": "org",
+            "description": "The organization name. The name is not case sensitive.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "group_id",
+            "description": "The unique identifier of the group.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "ExternalGroup",
+                  "description": "Information about an external group's usage and its members",
+                  "type": "object",
+                  "required": [
+                    "group_id",
+                    "group_name",
+                    "teams",
+                    "members"
+                  ],
+                  "properties": {
+                    "group_id": {
+                      "description": "The internal ID of the group",
+                      "example": 1,
+                      "type": "integer"
+                    },
+                    "group_name": {
+                      "description": "The display name for the group",
+                      "example": "group-azuread-test",
+                      "type": "string"
+                    },
+                    "updated_at": {
+                      "description": "The date when the group was last updated_at",
+                      "example": "2021-01-03 22:27:15:000 -700",
+                      "type": "string"
+                    },
+                    "teams": {
+                      "description": "An array of teams linked to this group",
+                      "example": [
+                        {
+                          "team_id": 1,
+                          "team_name": "team-test"
+                        },
+                        {
+                          "team_id": 2,
+                          "team_name": "team-test2"
+                        }
+                      ],
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "team_id",
+                          "team_name"
+                        ],
+                        "properties": {
+                          "team_id": {
+                            "description": "The id for a team",
+                            "example": 1,
+                            "type": "integer"
+                          },
+                          "team_name": {
+                            "description": "The name of the team",
+                            "example": "team-test",
+                            "type": "string"
+                          }
+                        }
+                      }
+                    },
+                    "members": {
+                      "description": "An array of external members linked to this group",
+                      "example": [
+                        {
+                          "member_id": 1,
+                          "member_login": "mona-lisa_eocsaxrs",
+                          "member_name": "Mona Lisa",
+                          "member_email": "mona_lisa@github.com"
+                        },
+                        {
+                          "member_id": 2,
+                          "member_login": "octo-lisa_eocsaxrs",
+                          "member_name": "Octo Lisa",
+                          "member_email": "octo_lisa@github.com"
+                        }
+                      ],
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "member_id",
+                          "member_login",
+                          "member_name",
+                          "member_email"
+                        ],
+                        "properties": {
+                          "member_id": {
+                            "description": "The internal user ID of the identity",
+                            "example": 1,
+                            "type": "integer"
+                          },
+                          "member_login": {
+                            "description": "The handle/login for the user",
+                            "example": "mona-lisa_eocsaxrs",
+                            "type": "string"
+                          },
+                          "member_name": {
+                            "description": "The user display name/profile name",
+                            "example": "Mona Lisa",
+                            "type": "string"
+                          },
+                          "member_email": {
+                            "description": "An email attached to a user",
+                            "example": "mona_lisa@github.com",
+                            "type": "string"
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "group_id": "123",
+                      "group_name": "Octocat admins",
+                      "updated_at": "2021-01-24T11:31:04-06:00",
+                      "teams": [
+                        {
+                          "team_id": 1,
+                          "team_name": "team-test"
+                        },
+                        {
+                          "team_id": 2,
+                          "team_name": "team-test2"
+                        }
+                      ],
+                      "members": [
+                        {
+                          "member_id": 1,
+                          "member_login": "mona-lisa_eocsaxrs",
+                          "member_name": "Mona Lisa",
+                          "member_email": "mona_lisa@github.com"
+                        },
+                        {
+                          "member_id": 2,
+                          "member_login": "octo-lisa_eocsaxrs",
+                          "member_name": "Octo Lisa",
+                          "member_email": "octo_lisa@github.com"
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": true,
+          "enabledForGitHubApps": true,
+          "category": "teams",
+          "subcategory": "external-groups"
+        },
+        "x-octokit": {}
+      }
+    },
+    "/orgs/{org}/external-groups": {
+      "get": {
+        "summary": "List external groups in an organization",
+        "description": "Lists external groups available in an organization. You can query the groups using the `display_name` parameter, only groups with a `group_name` containing the text provided in the `display_name` parameter will be returned.  You can also limit your page results using the `per_page` parameter. GitHub Enterprise Server generates a url-encoded `page` token using a cursor value for where the next page begins. For more information on cursor pagination, see \"[Offset and Cursor Pagination explained](https://dev.to/jackmarchant/offset-and-cursor-pagination-explained-b89).\"\n\nYou can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"[GitHub's products](https://docs.github.com/enterprise-server@3.6/github/getting-started-with-github/githubs-products)\" in the GitHub Help documentation.",
+        "tags": [
+          "teams"
+        ],
+        "operationId": "teams/list-external-idp-groups-for-org",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/enterprise-server@3.6/rest/reference/teams#list-external-idp-groups-for-an-organization"
+        },
+        "parameters": [
+          {
+            "name": "org",
+            "description": "The organization name. The name is not case sensitive.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "per_page",
+            "description": "The number of results per page (max 100).",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "default": 30
+            }
+          },
+          {
+            "name": "page",
+            "description": "Page token",
+            "in": "query",
+            "schema": {
+              "type": "integer"
+            }
+          },
+          {
+            "name": "display_name",
+            "description": "Limits the list to groups containing the text in the group name",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "ExternalGroups",
+                  "description": "A list of external groups available to be connected to a team",
+                  "type": "object",
+                  "properties": {
+                    "groups": {
+                      "description": "An array of external groups available to be mapped to a team",
+                      "example": [
+                        {
+                          "group_id": 1,
+                          "group_name": "group-azuread-test",
+                          "updated_at": "2021-01-03 22:27:15:000 -700"
+                        },
+                        {
+                          "group_id": 2,
+                          "group_name": "group-azuread-test2",
+                          "updated_at": "2021-06-03 22:27:15:000 -700"
+                        }
+                      ],
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "group_id",
+                          "group_name",
+                          "updated_at"
+                        ],
+                        "properties": {
+                          "group_id": {
+                            "description": "The internal ID of the group",
+                            "example": 1,
+                            "type": "integer"
+                          },
+                          "group_name": {
+                            "description": "The display name of the group",
+                            "example": "group-azuread-test",
+                            "type": "string"
+                          },
+                          "updated_at": {
+                            "description": "The time of the last update for this group",
+                            "example": "2019-06-03 22:27:15:000 -700",
+                            "type": "string"
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "groups": [
+                        {
+                          "group_id": "123",
+                          "group_name": "Octocat admins",
+                          "updated_at": "2021-01-24T11:31:04-06:00"
+                        },
+                        {
+                          "group_id": "456",
+                          "group_name": "Octocat docs members",
+                          "updated_at": "2021-03-24T11:31:04-06:00"
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            },
+            "headers": {
+              "Link": {
+                "example": "<https://api.github.com/resource?per_page=2&page=url-encoded-next-page-token>; rel=\"next\"",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": true,
+          "enabledForGitHubApps": true,
+          "category": "teams",
+          "subcategory": "external-groups"
+        },
+        "x-octokit": {}
+      }
+    },
     "/orgs/{org}/hooks": {
       "get": {
         "summary": "List organization webhooks",
@@ -86368,7 +86701,7 @@
           },
           {
             "name": "state",
-            "description": "Indicates the state of the issues to return. Can be either `open`, `closed`, or `all`.",
+            "description": "Indicates the state of the issues to return.",
             "in": "query",
             "required": false,
             "schema": {
@@ -86392,7 +86725,7 @@
           },
           {
             "name": "sort",
-            "description": "What to sort results by. Can be either `created`, `updated`, `comments`.",
+            "description": "What to sort results by.",
             "in": "query",
             "required": false,
             "schema": {
@@ -96536,7 +96869,7 @@
           },
           {
             "name": "state",
-            "description": "Indicates the state of the projects to return. Can be either `open`, `closed`, or `all`.",
+            "description": "Indicates the state of the projects to return.",
             "in": "query",
             "required": false,
             "schema": {
@@ -101475,7 +101808,7 @@
                         "description": "The REST API URL of the code locations for this alert."
                       },
                       "state": {
-                        "description": "Sets the state of the secret scanning alert. Can be either `open` or `resolved`. You must provide `resolution` when you set the state to `resolved`.",
+                        "description": "Sets the state of the secret scanning alert. You must provide `resolution` when you set the state to `resolved`.",
                         "type": "string",
                         "enum": [
                           "open",
@@ -110453,6 +110786,384 @@
         "x-octokit": {}
       }
     },
+    "/orgs/{org}/teams/{team_slug}/external-groups": {
+      "get": {
+        "summary": "List a connection between an external group and a team",
+        "description": "Lists a connection between a team and an external group.\n\nYou can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"[GitHub's products](https://docs.github.com/enterprise-server@3.6/github/getting-started-with-github/githubs-products)\" in the GitHub Help documentation.",
+        "tags": [
+          "teams"
+        ],
+        "operationId": "teams/list-linked-external-idp-groups-to-team-for-org",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/enterprise-server@3.6/rest/reference/teams#list-external-idp-group-team-connection"
+        },
+        "parameters": [
+          {
+            "name": "org",
+            "description": "The organization name. The name is not case sensitive.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "team_slug",
+            "description": "The slug of the team name.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "ExternalGroups",
+                  "description": "A list of external groups available to be connected to a team",
+                  "type": "object",
+                  "properties": {
+                    "groups": {
+                      "description": "An array of external groups available to be mapped to a team",
+                      "example": [
+                        {
+                          "group_id": 1,
+                          "group_name": "group-azuread-test",
+                          "updated_at": "2021-01-03 22:27:15:000 -700"
+                        },
+                        {
+                          "group_id": 2,
+                          "group_name": "group-azuread-test2",
+                          "updated_at": "2021-06-03 22:27:15:000 -700"
+                        }
+                      ],
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "group_id",
+                          "group_name",
+                          "updated_at"
+                        ],
+                        "properties": {
+                          "group_id": {
+                            "description": "The internal ID of the group",
+                            "example": 1,
+                            "type": "integer"
+                          },
+                          "group_name": {
+                            "description": "The display name of the group",
+                            "example": "group-azuread-test",
+                            "type": "string"
+                          },
+                          "updated_at": {
+                            "description": "The time of the last update for this group",
+                            "example": "2019-06-03 22:27:15:000 -700",
+                            "type": "string"
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "groups": [
+                        {
+                          "group_id": "123",
+                          "group_name": "Octocat admins",
+                          "updated_at": "2021-01-24T11:31:04-06:00"
+                        },
+                        {
+                          "group_id": "456",
+                          "group_name": "Octocat docs members",
+                          "updated_at": "2021-03-24T11:31:04-06:00"
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": true,
+          "enabledForGitHubApps": true,
+          "category": "teams",
+          "subcategory": "external-groups"
+        },
+        "x-octokit": {}
+      },
+      "patch": {
+        "summary": "Update the connection between an external group and a team",
+        "description": "Creates a connection between a team and an external group.  Only one external group can be linked to a team.\n\nYou can manage team membership with your identity provider using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see \"[GitHub's products](https://docs.github.com/enterprise-server@3.6/github/getting-started-with-github/githubs-products)\" in the GitHub Help documentation.",
+        "tags": [
+          "teams"
+        ],
+        "operationId": "teams/link-external-idp-group-to-team-for-org",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/enterprise-server@3.6/rest/reference/teams#link-external-idp-group-team-connection"
+        },
+        "parameters": [
+          {
+            "name": "org",
+            "description": "The organization name. The name is not case sensitive.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "team_slug",
+            "description": "The slug of the team name.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "group_id": {
+                    "type": "integer",
+                    "description": "External Group Id",
+                    "example": 1
+                  }
+                },
+                "required": [
+                  "group_id"
+                ]
+              },
+              "examples": {
+                "default": {
+                  "value": {
+                    "group_id": 123
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "ExternalGroup",
+                  "description": "Information about an external group's usage and its members",
+                  "type": "object",
+                  "required": [
+                    "group_id",
+                    "group_name",
+                    "teams",
+                    "members"
+                  ],
+                  "properties": {
+                    "group_id": {
+                      "description": "The internal ID of the group",
+                      "example": 1,
+                      "type": "integer"
+                    },
+                    "group_name": {
+                      "description": "The display name for the group",
+                      "example": "group-azuread-test",
+                      "type": "string"
+                    },
+                    "updated_at": {
+                      "description": "The date when the group was last updated_at",
+                      "example": "2021-01-03 22:27:15:000 -700",
+                      "type": "string"
+                    },
+                    "teams": {
+                      "description": "An array of teams linked to this group",
+                      "example": [
+                        {
+                          "team_id": 1,
+                          "team_name": "team-test"
+                        },
+                        {
+                          "team_id": 2,
+                          "team_name": "team-test2"
+                        }
+                      ],
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "team_id",
+                          "team_name"
+                        ],
+                        "properties": {
+                          "team_id": {
+                            "description": "The id for a team",
+                            "example": 1,
+                            "type": "integer"
+                          },
+                          "team_name": {
+                            "description": "The name of the team",
+                            "example": "team-test",
+                            "type": "string"
+                          }
+                        }
+                      }
+                    },
+                    "members": {
+                      "description": "An array of external members linked to this group",
+                      "example": [
+                        {
+                          "member_id": 1,
+                          "member_login": "mona-lisa_eocsaxrs",
+                          "member_name": "Mona Lisa",
+                          "member_email": "mona_lisa@github.com"
+                        },
+                        {
+                          "member_id": 2,
+                          "member_login": "octo-lisa_eocsaxrs",
+                          "member_name": "Octo Lisa",
+                          "member_email": "octo_lisa@github.com"
+                        }
+                      ],
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "member_id",
+                          "member_login",
+                          "member_name",
+                          "member_email"
+                        ],
+                        "properties": {
+                          "member_id": {
+                            "description": "The internal user ID of the identity",
+                            "example": 1,
+                            "type": "integer"
+                          },
+                          "member_login": {
+                            "description": "The handle/login for the user",
+                            "example": "mona-lisa_eocsaxrs",
+                            "type": "string"
+                          },
+                          "member_name": {
+                            "description": "The user display name/profile name",
+                            "example": "Mona Lisa",
+                            "type": "string"
+                          },
+                          "member_email": {
+                            "description": "An email attached to a user",
+                            "example": "mona_lisa@github.com",
+                            "type": "string"
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "group_id": "123",
+                      "group_name": "Octocat admins",
+                      "updated_at": "2021-01-24T11:31:04-06:00",
+                      "teams": [
+                        {
+                          "team_id": 1,
+                          "team_name": "team-test"
+                        },
+                        {
+                          "team_id": 2,
+                          "team_name": "team-test2"
+                        }
+                      ],
+                      "members": [
+                        {
+                          "member_id": 1,
+                          "member_login": "mona-lisa_eocsaxrs",
+                          "member_name": "Mona Lisa",
+                          "member_email": "mona_lisa@github.com"
+                        },
+                        {
+                          "member_id": 2,
+                          "member_login": "octo-lisa_eocsaxrs",
+                          "member_name": "Octo Lisa",
+                          "member_email": "octo_lisa@github.com"
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": true,
+          "enabledForGitHubApps": false,
+          "category": "teams",
+          "subcategory": "external-groups"
+        },
+        "x-octokit": {}
+      },
+      "delete": {
+        "summary": "Remove the connection between an external group and a team",
+        "description": "Deletes a connection between a team and an external group.\n\nYou can manage team membership with your IdP using Enterprise Managed Users for GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/enterprise-server@3.6/github/getting-started-with-github/githubs-products) in the GitHub Help documentation.",
+        "tags": [
+          "teams"
+        ],
+        "operationId": "teams/unlink-external-idp-group-from-team-for-org",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/enterprise-server@3.6/rest/reference/teams#unlink-external-idp-group-team-connection"
+        },
+        "parameters": [
+          {
+            "name": "org",
+            "description": "The organization name. The name is not case sensitive.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "team_slug",
+            "description": "The slug of the team name.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Response"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": true,
+          "enabledForGitHubApps": false,
+          "category": "teams",
+          "subcategory": "external-groups"
+        },
+        "x-octokit": {}
+      }
+    },
     "/orgs/{org}/teams/{team_slug}/members": {
       "get": {
         "summary": "List team members",
@@ -133390,7 +134101,16 @@
                       "description": "The outcome of the job.",
                       "example": "success",
                       "type": "string",
-                      "nullable": true
+                      "nullable": true,
+                      "enum": [
+                        "success",
+                        "failure",
+                        "neutral",
+                        "cancelled",
+                        "skipped",
+                        "timed_out",
+                        "action_required"
+                      ]
                     },
                     "started_at": {
                       "description": "The time that the job started, in ISO 8601 format.",
@@ -152706,7 +153426,16 @@
                             "description": "The outcome of the job.",
                             "example": "success",
                             "type": "string",
-                            "nullable": true
+                            "nullable": true,
+                            "enum": [
+                              "success",
+                              "failure",
+                              "neutral",
+                              "cancelled",
+                              "skipped",
+                              "timed_out",
+                              "action_required"
+                            ]
                           },
                           "started_at": {
                             "description": "The time that the job started, in ISO 8601 format.",
@@ -153322,7 +154051,16 @@
                             "description": "The outcome of the job.",
                             "example": "success",
                             "type": "string",
-                            "nullable": true
+                            "nullable": true,
+                            "enum": [
+                              "success",
+                              "failure",
+                              "neutral",
+                              "cancelled",
+                              "skipped",
+                              "timed_out",
+                              "action_required"
+                            ]
                           },
                           "started_at": {
                             "description": "The time that the job started, in ISO 8601 format.",
@@ -198181,7 +198919,7 @@
             }
           },
           "403": {
-            "description": "Response if the repository is archived or if github advanced security is not enabled for this repository",
+            "description": "Response if the repository is archived or if GitHub Advanced Security is not enabled for this repository",
             "content": {
               "application/json": {
                 "schema": {
@@ -199383,7 +200121,7 @@
             }
           },
           "403": {
-            "description": "Response if the repository is archived or if github advanced security is not enabled for this repository",
+            "description": "Response if the repository is archived or if GitHub Advanced Security is not enabled for this repository",
             "content": {
               "application/json": {
                 "schema": {
@@ -199589,7 +200327,7 @@
             "description": "Bad Request if the sarif field is invalid"
           },
           "403": {
-            "description": "Response if the repository is archived or if github advanced security is not enabled for this repository",
+            "description": "Response if the repository is archived or if GitHub Advanced Security is not enabled for this repository",
             "content": {
               "application/json": {
                 "schema": {
@@ -221427,7 +222165,7 @@
       },
       "put": {
         "summary": "Create or update file contents",
-        "description": "Creates a new file or replaces an existing file in a repository. You must authenticate using an access token with the `workflow` scope to use this endpoint.",
+        "description": "Creates a new file or replaces an existing file in a repository. You must authenticate using an access token with the `workflow` scope to use this endpoint.\n\n**Note:** If you use this endpoint and the \"[Delete a file](https://docs.github.com/enterprise-server@3.6/rest/reference/repos/#delete-file)\" endpoint in parallel, the concurrent requests will conflict and you will receive errors. You must use these endpoints serially instead.",
         "tags": [
           "repos"
         ],
@@ -222132,7 +222870,7 @@
       },
       "delete": {
         "summary": "Delete a file",
-        "description": "Deletes a file in a repository.\n\nYou can provide an additional `committer` parameter, which is an object containing information about the committer. Or, you can provide an `author` parameter, which is an object containing information about the author.\n\nThe `author` section is optional and is filled in with the `committer` information if omitted. If the `committer` information is omitted, the authenticated user's information is used.\n\nYou must provide values for both `name` and `email`, whether you choose to use `author` or `committer`. Otherwise, you'll receive a `422` status code.",
+        "description": "Deletes a file in a repository.\n\nYou can provide an additional `committer` parameter, which is an object containing information about the committer. Or, you can provide an `author` parameter, which is an object containing information about the author.\n\nThe `author` section is optional and is filled in with the `committer` information if omitted. If the `committer` information is omitted, the authenticated user's information is used.\n\nYou must provide values for both `name` and `email`, whether you choose to use `author` or `committer`. Otherwise, you'll receive a `422` status code.\n\n**Note:** If you use this endpoint and the \"[Create or update file contents](https://docs.github.com/enterprise-server@3.6/rest/reference/repos/#create-or-update-file-contents)\" endpoint in parallel, the concurrent requests will conflict and you will receive errors. You must use these endpoints serially instead.",
         "tags": [
           "repos"
         ],
@@ -233492,7 +234230,7 @@
           },
           {
             "name": "sort",
-            "description": "The sort order. Can be either `newest`, `oldest`, or `stargazers`.",
+            "description": "The sort order. `stargazers` will sort by star count.",
             "in": "query",
             "required": false,
             "schema": {
@@ -252375,7 +253113,7 @@
           },
           {
             "name": "state",
-            "description": "Indicates the state of the issues to return. Can be either `open`, `closed`, or `all`.",
+            "description": "Indicates the state of the issues to return.",
             "in": "query",
             "required": false,
             "schema": {
@@ -252426,7 +253164,7 @@
           },
           {
             "name": "sort",
-            "description": "What to sort results by. Can be either `created`, `updated`, `comments`.",
+            "description": "What to sort results by.",
             "in": "query",
             "required": false,
             "schema": {
@@ -312812,7 +313550,7 @@
           },
           {
             "name": "state",
-            "description": "Indicates the state of the projects to return. Can be either `open`, `closed`, or `all`.",
+            "description": "Indicates the state of the projects to return.",
             "in": "query",
             "required": false,
             "schema": {
@@ -313792,7 +314530,7 @@
           },
           {
             "name": "sort",
-            "description": "What to sort results by. Can be either `created`, `updated`, `popularity` (comment count) or `long-running` (age, filtering by pulls updated in the last month).",
+            "description": "What to sort results by. `popularity` will sort by the number of comments. `long-running` will sort by date created and will limit the results to pull requests that have been open for more than a month and have had activity within the past month.",
             "in": "query",
             "required": false,
             "schema": {
@@ -313808,7 +314546,7 @@
           },
           {
             "name": "direction",
-            "description": "The direction of the sort. Can be either `asc` or `desc`. Default: `desc` when sort is `created` or sort is not specified, otherwise `asc`.",
+            "description": "The direction of the sort. Default: `desc` when sort is `created` or sort is not specified, otherwise `asc`.",
             "in": "query",
             "required": false,
             "schema": {
@@ -321958,7 +322696,7 @@
           },
           {
             "name": "direction",
-            "description": "Can be either `asc` or `desc`. Ignored without `sort` parameter.",
+            "description": "The direction to sort results. Ignored without `sort` parameter.",
             "in": "query",
             "required": false,
             "schema": {
@@ -331395,7 +332133,7 @@
           },
           {
             "name": "direction",
-            "description": "Can be either `asc` or `desc`. Ignored without `sort` parameter.",
+            "description": "The direction to sort results. Ignored without `sort` parameter.",
             "in": "query",
             "required": false,
             "schema": {
@@ -355296,7 +356034,7 @@
                         "description": "The REST API URL of the code locations for this alert."
                       },
                       "state": {
-                        "description": "Sets the state of the secret scanning alert. Can be either `open` or `resolved`. You must provide `resolution` when you set the state to `resolved`.",
+                        "description": "Sets the state of the secret scanning alert. You must provide `resolution` when you set the state to `resolved`.",
                         "type": "string",
                         "enum": [
                           "open",
@@ -355794,7 +356532,7 @@
                       "description": "The REST API URL of the code locations for this alert."
                     },
                     "state": {
-                      "description": "Sets the state of the secret scanning alert. Can be either `open` or `resolved`. You must provide `resolution` when you set the state to `resolved`.",
+                      "description": "Sets the state of the secret scanning alert. You must provide `resolution` when you set the state to `resolved`.",
                       "type": "string",
                       "enum": [
                         "open",
@@ -356194,7 +356932,7 @@
                 "type": "object",
                 "properties": {
                   "state": {
-                    "description": "Sets the state of the secret scanning alert. Can be either `open` or `resolved`. You must provide `resolution` when you set the state to `resolved`.",
+                    "description": "Sets the state of the secret scanning alert. You must provide `resolution` when you set the state to `resolved`.",
                     "type": "string",
                     "enum": [
                       "open",
@@ -356272,7 +357010,7 @@
                       "description": "The REST API URL of the code locations for this alert."
                     },
                     "state": {
-                      "description": "Sets the state of the secret scanning alert. Can be either `open` or `resolved`. You must provide `resolution` when you set the state to `resolved`.",
+                      "description": "Sets the state of the secret scanning alert. You must provide `resolution` when you set the state to `resolved`.",
                       "type": "string",
                       "enum": [
                         "open",
@@ -396434,7 +397172,7 @@
           },
           {
             "name": "state",
-            "description": "Indicates the state of the issues to return. Can be either `open`, `closed`, or `all`.",
+            "description": "Indicates the state of the issues to return.",
             "in": "query",
             "required": false,
             "schema": {
@@ -396458,7 +397196,7 @@
           },
           {
             "name": "sort",
-            "description": "What to sort results by. Can be either `created`, `updated`, `comments`.",
+            "description": "What to sort results by.",
             "in": "query",
             "required": false,
             "schema": {
@@ -400063,7 +400801,7 @@
         "parameters": [
           {
             "name": "state",
-            "description": "Indicates the state of the memberships to return. Can be either `active` or `pending`. If not specified, the API returns both active and pending memberships.",
+            "description": "Indicates the state of the memberships to return. If not specified, the API returns both active and pending memberships.",
             "in": "query",
             "required": false,
             "schema": {
@@ -432513,7 +433251,7 @@
           },
           {
             "name": "state",
-            "description": "Indicates the state of the projects to return. Can be either `open`, `closed`, or `all`.",
+            "description": "Indicates the state of the projects to return.",
             "in": "query",
             "required": false,
             "schema": {
@@ -448651,50 +449389,6 @@
         }
       }
     },
-    "/orgs/{org}/external-group/{group_id}": {
-      "get": {
-        "summary": "Get an external group",
-        "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com",
-        "tags": [
-          "teams"
-        ],
-        "operationId": "teams/external-idp-group-info-for-org",
-        "externalDocs": {
-          "description": "API method documentation",
-          "url": "https://docs.github.com/rest/reference/teams#external-idp-group-info-for-an-organization"
-        },
-        "x-octokit": {
-          "api.github.com": "removed"
-        },
-        "responses": {
-          "501": {
-            "description": "Not Implemented"
-          }
-        }
-      }
-    },
-    "/orgs/{org}/external-groups": {
-      "get": {
-        "summary": "List external groups in an organization",
-        "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com",
-        "tags": [
-          "teams"
-        ],
-        "operationId": "teams/list-external-idp-groups-for-org",
-        "externalDocs": {
-          "description": "API method documentation",
-          "url": "https://docs.github.com/rest/reference/teams#list-external-idp-groups-for-an-organization"
-        },
-        "x-octokit": {
-          "api.github.com": "removed"
-        },
-        "responses": {
-          "501": {
-            "description": "Not Implemented"
-          }
-        }
-      }
-    },
     "/orgs/{org}/failed_invitations": {
       "get": {
         "summary": "List failed organization invitations",
@@ -449341,68 +450035,6 @@
         }
       }
     },
-    "/orgs/{org}/teams/{team_slug}/external-groups": {
-      "get": {
-        "summary": "List a connection between an external group and a team",
-        "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com",
-        "tags": [
-          "teams"
-        ],
-        "operationId": "teams/list-linked-external-idp-groups-to-team-for-org",
-        "externalDocs": {
-          "description": "API method documentation",
-          "url": "https://docs.github.com/rest/reference/teams#list-external-idp-group-team-connection"
-        },
-        "x-octokit": {
-          "api.github.com": "removed"
-        },
-        "responses": {
-          "501": {
-            "description": "Not Implemented"
-          }
-        }
-      },
-      "delete": {
-        "summary": "Remove the connection between an external group and a team",
-        "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com",
-        "tags": [
-          "teams"
-        ],
-        "operationId": "teams/unlink-external-idp-group-from-team-for-org",
-        "externalDocs": {
-          "description": "API method documentation",
-          "url": "https://docs.github.com/rest/reference/teams#unlink-external-idp-group-team-connection"
-        },
-        "x-octokit": {
-          "api.github.com": "removed"
-        },
-        "responses": {
-          "501": {
-            "description": "Not Implemented"
-          }
-        }
-      },
-      "patch": {
-        "summary": "Update the connection between an external group and a team",
-        "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com",
-        "tags": [
-          "teams"
-        ],
-        "operationId": "teams/link-external-idp-group-to-team-for-org",
-        "externalDocs": {
-          "description": "API method documentation",
-          "url": "https://docs.github.com/rest/reference/teams#link-external-idp-group-team-connection"
-        },
-        "x-octokit": {
-          "api.github.com": "removed"
-        },
-        "responses": {
-          "501": {
-            "description": "Not Implemented"
-          }
-        }
-      }
-    },
     "/orgs/{org}/teams/{team_slug}/invitations": {
       "get": {
         "summary": "List pending team invitations",
@@ -449703,6 +450335,50 @@
         }
       }
     },
+    "/repos/{owner}/{repo}/code-scanning/codeql/databases": {
+      "get": {
+        "summary": "List CodeQL databases for a repository",
+        "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com",
+        "tags": [
+          "code-scanning"
+        ],
+        "operationId": "code-scanning/list-codeql-databases",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/reference/code-scanning#list-codeql-databases"
+        },
+        "x-octokit": {
+          "api.github.com": "removed"
+        },
+        "responses": {
+          "501": {
+            "description": "Not Implemented"
+          }
+        }
+      }
+    },
+    "/repos/{owner}/{repo}/code-scanning/codeql/databases/{language}": {
+      "get": {
+        "summary": "Get a CodeQL database for a repository",
+        "description": "This endpoint does not exist in GitHub Enterprise Server 3.6. It was added in api.github.com",
+        "tags": [
+          "code-scanning"
+        ],
+        "operationId": "code-scanning/get-codeql-database",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/reference/code-scanning#get-codeql-database"
+        },
+        "x-octokit": {
+          "api.github.com": "removed"
+        },
+        "responses": {
+          "501": {
+            "description": "Not Implemented"
+          }
+        }
+      }
+    },
     "/repos/{owner}/{repo}/codespaces": {
       "get": {
         "summary": "List codespaces in a repository for the authenticated user",