@octokit/openapi 5.7.0 → 5.8.0

package/generated/ghes-3.2-diff-to-api.github.com.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "5.7.0",
+    "version": "5.8.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": { "name": "MIT", "url": "https://spdx.org/licenses/MIT" },
@@ -2604,6 +2604,41 @@
         "x-octokit": {
           "diff": { "api.github.com.json": { "type": "changed" } }
         }
+      },
+      "put": {
+        "summary": "Set allowed actions for an enterprise",
+        "description": "Sets the actions that are allowed in an enterprise. To use this endpoint, the enterprise permission policy for `allowed_actions` must be configured to `selected`. For more information, see \"[Set GitHub Actions permissions for an enterprise](#set-github-actions-permissions-for-an-enterprise).\"\n\nYou must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.",
+        "operationId": "enterprise-admin/set-allowed-actions-enterprise",
+        "tags": ["enterprise-admin"],
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/enterprise-server@3.2/rest/reference/enterprise-admin#set-allowed-actions-for-an-enterprise"
+        },
+        "parameters": [{ "$ref": "#/components/parameters/enterprise" }],
+        "responses": { "204": { "description": "Response" } },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": { "$ref": "#/components/schemas/selected-actions" },
+              "examples": {
+                "selected_actions": {
+                  "$ref": "#/components/examples/selected-actions"
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "enabledForGitHubApps": false,
+          "githubCloudOnly": false,
+          "previews": [],
+          "category": "enterprise-admin",
+          "subcategory": "actions"
+        },
+        "x-octokit": {
+          "diff": { "api.github.com.json": { "type": "changed" } }
+        }
       }
     },
     "/meta": {
@@ -2643,6 +2678,159 @@
         }
       }
     },
+    "/orgs/{org}": {
+      "patch": {
+        "summary": "Update an organization",
+        "description": "**Parameter Deprecation Notice:** GitHub Enterprise Server will replace and discontinue `members_allowed_repository_creation_type` in favor of more granular permissions. The new input parameters are `members_can_create_public_repositories`, `members_can_create_private_repositories` for all organizations and `members_can_create_internal_repositories` for organizations associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+. For more information, see the [blog post](https://developer.github.com/changes/2019-12-03-internal-visibility-changes).\n\nEnables an authenticated organization owner with the `admin:org` scope to update the organization's profile and member privileges.",
+        "tags": ["orgs"],
+        "operationId": "orgs/update",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/enterprise-server@3.2/rest/reference/orgs/#update-an-organization"
+        },
+        "parameters": [{ "$ref": "#/components/parameters/org" }],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "billing_email": {
+                    "type": "string",
+                    "description": "Billing email address. This address is not publicized."
+                  },
+                  "company": {
+                    "type": "string",
+                    "description": "The company name."
+                  },
+                  "email": {
+                    "type": "string",
+                    "description": "The publicly visible email address."
+                  },
+                  "twitter_username": {
+                    "type": "string",
+                    "description": "The Twitter username of the company."
+                  },
+                  "location": {
+                    "type": "string",
+                    "description": "The location."
+                  },
+                  "name": {
+                    "type": "string",
+                    "description": "The shorthand name of the company."
+                  },
+                  "description": {
+                    "type": "string",
+                    "description": "The description of the company."
+                  },
+                  "has_organization_projects": {
+                    "type": "boolean",
+                    "description": "Toggles whether an organization can use organization projects."
+                  },
+                  "has_repository_projects": {
+                    "type": "boolean",
+                    "description": "Toggles whether repositories that belong to the organization can use repository projects."
+                  },
+                  "default_repository_permission": {
+                    "type": "string",
+                    "description": "Default permission level members have for organization repositories:  \n\\* `read` - can pull, but not push to or administer this repository.  \n\\* `write` - can pull and push, but not administer this repository.  \n\\* `admin` - can pull, push, and administer this repository.  \n\\* `none` - no permissions granted by default.",
+                    "enum": ["read", "write", "admin", "none"],
+                    "default": "read"
+                  },
+                  "members_can_create_repositories": {
+                    "type": "boolean",
+                    "description": "Toggles the ability of non-admin organization members to create repositories. Can be one of:  \n\\* `true` - all organization members can create repositories.  \n\\* `false` - only organization owners can create repositories.  \nDefault: `true`  \n**Note:** A parameter can override this parameter. See `members_allowed_repository_creation_type` in this table for details. **Note:** A parameter can override this parameter. See `members_allowed_repository_creation_type` in this table for details.",
+                    "default": true
+                  },
+                  "members_can_create_internal_repositories": {
+                    "type": "boolean",
+                    "description": "Toggles whether organization members can create internal repositories, which are visible to all enterprise members. You can only allow members to create internal repositories if your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+. Can be one of:  \n\\* `true` - all organization members can create internal repositories.  \n\\* `false` - only organization owners can create internal repositories.  \nDefault: `true`. For more information, see \"[Restricting repository creation in your organization](https://help.github.com/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization)\" in the GitHub Help documentation."
+                  },
+                  "members_can_create_private_repositories": {
+                    "type": "boolean",
+                    "description": "Toggles whether organization members can create private repositories, which are visible to organization members with permission. Can be one of:  \n\\* `true` - all organization members can create private repositories.  \n\\* `false` - only organization owners can create private repositories.  \nDefault: `true`. For more information, see \"[Restricting repository creation in your organization](https://help.github.com/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization)\" in the GitHub Help documentation."
+                  },
+                  "members_can_create_public_repositories": {
+                    "type": "boolean",
+                    "description": "Toggles whether organization members can create public repositories, which are visible to anyone. Can be one of:  \n\\* `true` - all organization members can create public repositories.  \n\\* `false` - only organization owners can create public repositories.  \nDefault: `true`. For more information, see \"[Restricting repository creation in your organization](https://help.github.com/github/setting-up-and-managing-organizations-and-teams/restricting-repository-creation-in-your-organization)\" in the GitHub Help documentation."
+                  },
+                  "members_allowed_repository_creation_type": {
+                    "type": "string",
+                    "description": "Specifies which types of repositories non-admin organization members can create. Can be one of:  \n\\* `all` - all organization members can create public and private repositories.  \n\\* `private` - members can create private repositories. This option is only available to repositories that are part of an organization on GitHub Enterprise Cloud.  \n\\* `none` - only admin members can create repositories.  \n**Note:** This parameter is deprecated and will be removed in the future. Its return value ignores internal repositories. Using this parameter overrides values set in `members_can_create_repositories`. See the parameter deprecation notice in the operation description for details.",
+                    "enum": ["all", "private", "none"]
+                  },
+                  "members_can_create_pages": {
+                    "type": "boolean",
+                    "description": "Toggles whether organization members can create GitHub Pages sites. Can be one of:  \n\\* `true` - all organization members can create GitHub Pages sites.  \n\\* `false` - no organization members can create GitHub Pages sites. Existing published sites will not be impacted.",
+                    "default": true
+                  },
+                  "blog": {
+                    "type": "string",
+                    "example": "\"http://github.blog\""
+                  }
+                }
+              },
+              "example": {
+                "billing_email": "mona@github.com",
+                "company": "GitHub",
+                "email": "mona@github.com",
+                "twitter_username": "github",
+                "location": "San Francisco",
+                "name": "github",
+                "description": "GitHub, the company.",
+                "default_repository_permission": "read",
+                "members_can_create_repositories": true,
+                "members_allowed_repository_creation_type": "all"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": { "$ref": "#/components/schemas/organization-full" },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/organization-full"
+                  }
+                }
+              }
+            }
+          },
+          "409": { "$ref": "#/components/responses/conflict" },
+          "422": {
+            "description": "Validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "oneOf": [
+                    { "$ref": "#/components/schemas/validation-error" },
+                    { "$ref": "#/components/schemas/validation-error-simple" }
+                  ]
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "orgs",
+          "previews": [
+            {
+              "required": false,
+              "name": "surtur",
+              "note": "New repository creation permissions are available to preview. You can now use `members_can_create_public_repositories`, `members_can_create_private_repositories`, and `members_can_create_internal_repositories`. You can only allow members to create internal repositories if your organization is associated with an enterprise account using GitHub Enterprise Cloud or GitHub Enterprise Server 2.20+. These parameters provide more granular permissions to configure the type of repositories organization members can create.\n\nTo access these new parameters during the preview period, you must provide a custom [media type](https://docs.github.com/enterprise-server@3.2/rest/overview/media-types) in the `Accept` header:\n```shell\napplication/vnd.github.surtur-preview+json\n```"
+            }
+          ]
+        },
+        "x-octokit": {
+          "diff": { "api.github.com.json": { "type": "changed" } }
+        }
+      }
+    },
     "/orgs/{org}/actions/permissions/selected-actions": {
       "get": {
         "summary": "Get allowed actions for an organization",
@@ -2679,6 +2867,40 @@
         "x-octokit": {
           "diff": { "api.github.com.json": { "type": "changed" } }
         }
+      },
+      "put": {
+        "summary": "Set allowed actions for an organization",
+        "description": "Sets the actions that are allowed in an organization. To use this endpoint, the organization permission policy for `allowed_actions` must be configured to `selected`. For more information, see \"[Set GitHub Actions permissions for an organization](#set-github-actions-permissions-for-an-organization).\"\n\nIf the organization belongs to an enterprise that has `selected` actions set at the enterprise level, then you cannot override any of the enterprise's allowed actions settings.\n\nTo use the `patterns_allowed` setting for private repositories, the organization must belong to an enterprise. If the organization does not belong to an enterprise, then the `patterns_allowed` setting only applies to public repositories in the organization.\n\nYou must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `administration` organization permission to use this API.",
+        "operationId": "actions/set-allowed-actions-organization",
+        "tags": ["actions"],
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/enterprise-server@3.2/rest/reference/actions#set-allowed-actions-for-an-organization"
+        },
+        "parameters": [{ "$ref": "#/components/parameters/org" }],
+        "responses": { "204": { "description": "Response" } },
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": { "$ref": "#/components/schemas/selected-actions" },
+              "examples": {
+                "selected_actions": {
+                  "$ref": "#/components/examples/selected-actions"
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "enabledForGitHubApps": true,
+          "githubCloudOnly": false,
+          "previews": [],
+          "category": "actions",
+          "subcategory": "permissions"
+        },
+        "x-octokit": {
+          "diff": { "api.github.com.json": { "type": "changed" } }
+        }
       }
     },
     "/orgs/{org}/pre-receive-hooks": {
@@ -2983,6 +3205,43 @@
         "x-octokit": {
           "diff": { "api.github.com.json": { "type": "changed" } }
         }
+      },
+      "put": {
+        "summary": "Set allowed actions for a repository",
+        "description": "Sets the actions that are allowed in a repository. To use this endpoint, the repository permission policy for `allowed_actions` must be configured to `selected`. For more information, see \"[Set GitHub Actions permissions for a repository](#set-github-actions-permissions-for-a-repository).\"\n\nIf the repository belongs to an organization or enterprise that has `selected` actions set at the organization or enterprise levels, then you cannot override any of the allowed actions settings.\n\nTo use the `patterns_allowed` setting for private repositories, the repository must belong to an enterprise. If the repository does not belong to an enterprise, then the `patterns_allowed` setting only applies to public repositories.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `administration` repository permission to use this API.",
+        "operationId": "actions/set-allowed-actions-repository",
+        "tags": ["actions"],
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/enterprise-server@3.2/rest/reference/actions#set-allowed-actions-for-a-repository"
+        },
+        "parameters": [
+          { "$ref": "#/components/parameters/owner" },
+          { "$ref": "#/components/parameters/repo" }
+        ],
+        "responses": { "204": { "description": "Response" } },
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": { "$ref": "#/components/schemas/selected-actions" },
+              "examples": {
+                "selected_actions": {
+                  "$ref": "#/components/examples/selected-actions"
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "enabledForGitHubApps": true,
+          "githubCloudOnly": false,
+          "previews": [],
+          "category": "actions",
+          "subcategory": "permissions"
+        },
+        "x-octokit": {
+          "diff": { "api.github.com.json": { "type": "changed" } }
+        }
       }
     },
     "/repos/{owner}/{repo}/actions/runs/{run_id}/jobs": {
@@ -3104,6 +3363,75 @@
           ],
           "diff": { "api.github.com.json": { "type": "changed" } }
         }
+      },
+      "patch": {
+        "summary": "Update a code scanning alert",
+        "description": "Updates the status of a single code scanning alert. You must use an access token with the `security_events` scope to use this endpoint. GitHub Apps must have the `security_events` write permission to use this endpoint.",
+        "operationId": "code-scanning/update-alert",
+        "tags": ["code-scanning"],
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/enterprise-server@3.2/rest/reference/code-scanning#update-a-code-scanning-alert"
+        },
+        "parameters": [
+          { "$ref": "#/components/parameters/owner" },
+          { "$ref": "#/components/parameters/repo" },
+          { "$ref": "#/components/parameters/alert-number" }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "state": {
+                    "$ref": "#/components/schemas/code-scanning-alert-set-state"
+                  },
+                  "dismissed_reason": {
+                    "$ref": "#/components/schemas/code-scanning-alert-dismissed-reason"
+                  }
+                },
+                "required": ["state"]
+              },
+              "example": {
+                "state": "dismissed",
+                "dismissed_reason": "false positive"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/code-scanning-alert"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/code-scanning-alert-dismissed"
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "$ref": "#/components/responses/code_scanning_forbidden_write"
+          },
+          "404": { "$ref": "#/components/responses/not_found" },
+          "503": { "$ref": "#/components/responses/service_unavailable" }
+        },
+        "x-github": {
+          "enabledForGitHubApps": true,
+          "githubCloudOnly": false,
+          "previews": [],
+          "category": "code-scanning"
+        },
+        "x-octokit": {
+          "diff": { "api.github.com.json": { "type": "changed" } }
+        }
       }
     },
     "/repos/{owner}/{repo}/code-scanning/analyses": {
@@ -3468,24 +3796,116 @@
           { "$ref": "#/components/parameters/page" }
         ],
         "responses": {
-          "200": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": { "$ref": "#/components/schemas/release" }
+                },
+                "examples": {
+                  "default": { "$ref": "#/components/examples/release-items" }
+                }
+              }
+            },
+            "headers": { "Link": { "$ref": "#/components/headers/link" } }
+          },
+          "404": { "$ref": "#/components/responses/not_found" }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "previews": [],
+          "category": "repos",
+          "subcategory": "releases"
+        },
+        "x-octokit": {
+          "diff": { "api.github.com.json": { "type": "changed" } }
+        }
+      },
+      "post": {
+        "summary": "Create a release",
+        "description": "Users with push access to the repository can create a release.\n\nThis endpoint triggers [notifications](https://docs.github.com/en/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. See \"[Secondary rate limits](https://docs.github.com/enterprise-server@3.2/rest/overview/resources-in-the-rest-api#secondary-rate-limits)\" and \"[Dealing with secondary rate limits](https://docs.github.com/enterprise-server@3.2/rest/guides/best-practices-for-integrators#dealing-with-secondary-rate-limits)\" for details.",
+        "tags": ["repos"],
+        "operationId": "repos/create-release",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/enterprise-server@3.2/rest/reference/repos#create-a-release"
+        },
+        "parameters": [
+          { "$ref": "#/components/parameters/owner" },
+          { "$ref": "#/components/parameters/repo" }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "tag_name": {
+                    "type": "string",
+                    "description": "The name of the tag."
+                  },
+                  "target_commitish": {
+                    "type": "string",
+                    "description": "Specifies the commitish value that determines where the Git tag is created from. Can be any branch or commit SHA. Unused if the Git tag already exists. Default: the repository's default branch (usually `master`)."
+                  },
+                  "name": {
+                    "type": "string",
+                    "description": "The name of the release."
+                  },
+                  "body": {
+                    "type": "string",
+                    "description": "Text describing the contents of the tag."
+                  },
+                  "draft": {
+                    "type": "boolean",
+                    "description": "`true` to create a draft (unpublished) release, `false` to create a published one.",
+                    "default": false
+                  },
+                  "prerelease": {
+                    "type": "boolean",
+                    "description": "`true` to identify the release as a prerelease. `false` to identify the release as a full release.",
+                    "default": false
+                  }
+                },
+                "required": ["tag_name"]
+              },
+              "example": {
+                "tag_name": "v1.0.0",
+                "target_commitish": "master",
+                "name": "v1.0.0",
+                "body": "Description of the release",
+                "draft": false,
+                "prerelease": false
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
             "description": "Response",
             "content": {
               "application/json": {
-                "schema": {
-                  "type": "array",
-                  "items": { "$ref": "#/components/schemas/release" }
-                },
+                "schema": { "$ref": "#/components/schemas/release" },
                 "examples": {
-                  "default": { "$ref": "#/components/examples/release-items" }
+                  "default": { "$ref": "#/components/examples/release" }
                 }
               }
             },
-            "headers": { "Link": { "$ref": "#/components/headers/link" } }
+            "headers": {
+              "Location": {
+                "example": "https://api.github.com/repos/octocat/Hello-World/releases/1",
+                "schema": { "type": "string" }
+              }
+            }
           },
-          "404": { "$ref": "#/components/responses/not_found" }
+          "422": { "$ref": "#/components/responses/validation_failed" }
         },
         "x-github": {
+          "triggersNotification": true,
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
           "previews": [],
@@ -3623,6 +4043,87 @@
         "x-octokit": {
           "diff": { "api.github.com.json": { "type": "changed" } }
         }
+      },
+      "patch": {
+        "summary": "Update a release",
+        "description": "Users with push access to the repository can edit a release.",
+        "tags": ["repos"],
+        "operationId": "repos/update-release",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/enterprise-server@3.2/rest/reference/repos#update-a-release"
+        },
+        "parameters": [
+          { "$ref": "#/components/parameters/owner" },
+          { "$ref": "#/components/parameters/repo" },
+          { "$ref": "#/components/parameters/release-id" }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "tag_name": {
+                    "type": "string",
+                    "description": "The name of the tag."
+                  },
+                  "target_commitish": {
+                    "type": "string",
+                    "description": "Specifies the commitish value that determines where the Git tag is created from. Can be any branch or commit SHA. Unused if the Git tag already exists. Default: the repository's default branch (usually `master`)."
+                  },
+                  "name": {
+                    "type": "string",
+                    "description": "The name of the release."
+                  },
+                  "body": {
+                    "type": "string",
+                    "description": "Text describing the contents of the tag."
+                  },
+                  "draft": {
+                    "type": "boolean",
+                    "description": "`true` makes the release a draft, and `false` publishes the release."
+                  },
+                  "prerelease": {
+                    "type": "boolean",
+                    "description": "`true` to identify the release as a prerelease, `false` to identify the release as a full release."
+                  }
+                }
+              },
+              "example": {
+                "tag_name": "v1.0.0",
+                "target_commitish": "master",
+                "name": "v1.0.0",
+                "body": "Description of the release",
+                "draft": false,
+                "prerelease": false
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": { "$ref": "#/components/schemas/release" },
+                "examples": {
+                  "default": { "$ref": "#/components/examples/release" }
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "previews": [],
+          "category": "repos",
+          "subcategory": "releases"
+        },
+        "x-octokit": {
+          "diff": { "api.github.com.json": { "type": "changed" } }
+        }
       }
     },
     "/repositories": {
@@ -5205,65 +5706,298 @@
           "total_wikis": { "type": "integer" }
         },
         "required": [
-          "total_repos",
-          "root_repos",
-          "fork_repos",
-          "org_repos",
-          "total_pushes",
-          "total_wikis"
+          "total_repos",
+          "root_repos",
+          "fork_repos",
+          "org_repos",
+          "total_pushes",
+          "total_wikis"
+        ]
+      },
+      "enterprise-user-overview": {
+        "title": "Enterprise User Stats",
+        "type": "object",
+        "properties": {
+          "total_users": { "type": "integer" },
+          "admin_users": { "type": "integer" },
+          "suspended_users": { "type": "integer" }
+        },
+        "required": ["total_users", "admin_users", "suspended_users"]
+      },
+      "selected-actions": {
+        "type": "object",
+        "properties": {
+          "github_owned_allowed": {
+            "type": "boolean",
+            "description": "Whether GitHub-owned actions are allowed. For example, this includes the actions in the `actions` organization."
+          },
+          "patterns_allowed": {
+            "type": "array",
+            "description": "Specifies a list of string-matching patterns to allow specific action(s). Wildcards, tags, and SHAs are allowed. For example, `monalisa/octocat@*`, `monalisa/octocat@v2`, `monalisa/*`.\"",
+            "items": { "type": "string" }
+          }
+        },
+        "required": ["github_owned_allowed", "patterns_allowed"]
+      },
+      "api-overview": {
+        "title": "Api Overview",
+        "description": "Api Overview",
+        "type": "object",
+        "properties": {
+          "verifiable_password_authentication": {
+            "type": "boolean",
+            "example": true
+          },
+          "packages": {
+            "type": "array",
+            "items": { "type": "string" },
+            "example": [
+              "13.65.0.0/16",
+              "157.55.204.33/32",
+              "2a01:111:f403:f90c::/62"
+            ]
+          },
+          "dependabot": {
+            "type": "array",
+            "items": { "type": "string" },
+            "example": ["192.168.7.15/32", "192.168.7.16/32"]
+          },
+          "installed_version": { "type": "string", "example": "3.2.0" }
+        },
+        "required": ["verifiable_password_authentication"]
+      },
+      "organization-full": {
+        "title": "Organization Full",
+        "description": "Organization Full",
+        "type": "object",
+        "properties": {
+          "login": { "type": "string", "example": "github" },
+          "id": { "type": "integer", "example": 1 },
+          "node_id": {
+            "type": "string",
+            "example": "MDEyOk9yZ2FuaXphdGlvbjE="
+          },
+          "url": {
+            "type": "string",
+            "format": "uri",
+            "example": "https://api.github.com/orgs/github"
+          },
+          "repos_url": {
+            "type": "string",
+            "format": "uri",
+            "example": "https://api.github.com/orgs/github/repos"
+          },
+          "events_url": {
+            "type": "string",
+            "format": "uri",
+            "example": "https://api.github.com/orgs/github/events"
+          },
+          "hooks_url": {
+            "type": "string",
+            "example": "https://api.github.com/orgs/github/hooks"
+          },
+          "issues_url": {
+            "type": "string",
+            "example": "https://api.github.com/orgs/github/issues"
+          },
+          "members_url": {
+            "type": "string",
+            "example": "https://api.github.com/orgs/github/members{/member}"
+          },
+          "public_members_url": {
+            "type": "string",
+            "example": "https://api.github.com/orgs/github/public_members{/member}"
+          },
+          "avatar_url": {
+            "type": "string",
+            "example": "https://github.com/images/error/octocat_happy.gif"
+          },
+          "description": {
+            "type": "string",
+            "example": "A great organization",
+            "nullable": true
+          },
+          "name": { "type": "string", "example": "github" },
+          "company": { "type": "string", "example": "GitHub" },
+          "blog": {
+            "type": "string",
+            "format": "uri",
+            "example": "https://github.com/blog"
+          },
+          "location": { "type": "string", "example": "San Francisco" },
+          "email": {
+            "type": "string",
+            "format": "email",
+            "example": "octocat@github.com"
+          },
+          "twitter_username": {
+            "type": "string",
+            "example": "github",
+            "nullable": true
+          },
+          "is_verified": { "type": "boolean", "example": true },
+          "has_organization_projects": { "type": "boolean", "example": true },
+          "has_repository_projects": { "type": "boolean", "example": true },
+          "public_repos": { "type": "integer", "example": 2 },
+          "public_gists": { "type": "integer", "example": 1 },
+          "followers": { "type": "integer", "example": 20 },
+          "following": { "type": "integer", "example": 0 },
+          "html_url": {
+            "type": "string",
+            "format": "uri",
+            "example": "https://github.com/octocat"
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time",
+            "example": "2008-01-14T04:33:35Z"
+          },
+          "type": { "type": "string", "example": "Organization" },
+          "total_private_repos": { "type": "integer", "example": 100 },
+          "owned_private_repos": { "type": "integer", "example": 100 },
+          "private_gists": {
+            "type": "integer",
+            "example": 81,
+            "nullable": true
+          },
+          "disk_usage": {
+            "type": "integer",
+            "example": 10000,
+            "nullable": true
+          },
+          "collaborators": {
+            "type": "integer",
+            "example": 8,
+            "nullable": true
+          },
+          "billing_email": {
+            "type": "string",
+            "format": "email",
+            "example": "org@example.com",
+            "nullable": true
+          },
+          "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",
+            "nullable": true
+          },
+          "members_can_create_repositories": {
+            "type": "boolean",
+            "example": true,
+            "nullable": true
+          },
+          "two_factor_requirement_enabled": {
+            "type": "boolean",
+            "example": true,
+            "nullable": true
+          },
+          "members_allowed_repository_creation_type": {
+            "type": "string",
+            "example": "all"
+          },
+          "members_can_create_public_repositories": {
+            "type": "boolean",
+            "example": true
+          },
+          "members_can_create_private_repositories": {
+            "type": "boolean",
+            "example": true
+          },
+          "members_can_create_internal_repositories": {
+            "type": "boolean",
+            "example": true
+          },
+          "members_can_create_pages": { "type": "boolean", "example": true },
+          "members_can_create_public_pages": {
+            "type": "boolean",
+            "example": true
+          },
+          "members_can_create_private_pages": {
+            "type": "boolean",
+            "example": 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"
         ]
       },
-      "enterprise-user-overview": {
-        "title": "Enterprise User Stats",
-        "type": "object",
-        "properties": {
-          "total_users": { "type": "integer" },
-          "admin_users": { "type": "integer" },
-          "suspended_users": { "type": "integer" }
-        },
-        "required": ["total_users", "admin_users", "suspended_users"]
-      },
-      "selected-actions": {
+      "validation-error": {
+        "title": "Validation Error",
+        "description": "Validation Error",
         "type": "object",
+        "required": ["message", "documentation_url"],
         "properties": {
-          "github_owned_allowed": {
-            "type": "boolean",
-            "description": "Whether GitHub-owned actions are allowed. For example, this includes the actions in the `actions` organization."
-          },
-          "patterns_allowed": {
+          "message": { "type": "string" },
+          "documentation_url": { "type": "string" },
+          "errors": {
             "type": "array",
-            "description": "Specifies a list of string-matching patterns to allow specific action(s). Wildcards, tags, and SHAs are allowed. For example, `monalisa/octocat@*`, `monalisa/octocat@v2`, `monalisa/*`.\"",
-            "items": { "type": "string" }
+            "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", "nullable": true },
+                    { "type": "integer", "nullable": true },
+                    {
+                      "type": "array",
+                      "nullable": true,
+                      "items": { "type": "string" }
+                    }
+                  ]
+                }
+              }
+            }
           }
-        },
-        "required": ["github_owned_allowed", "patterns_allowed"]
+        }
       },
-      "api-overview": {
-        "title": "Api Overview",
-        "description": "Api Overview",
+      "validation-error-simple": {
+        "title": "Validation Error Simple",
+        "description": "Validation Error Simple",
         "type": "object",
+        "required": ["message", "documentation_url"],
         "properties": {
-          "verifiable_password_authentication": {
-            "type": "boolean",
-            "example": true
-          },
-          "packages": {
-            "type": "array",
-            "items": { "type": "string" },
-            "example": [
-              "13.65.0.0/16",
-              "157.55.204.33/32",
-              "2a01:111:f403:f90c::/62"
-            ]
-          },
-          "dependabot": {
-            "type": "array",
-            "items": { "type": "string" },
-            "example": ["192.168.7.15/32", "192.168.7.16/32"]
-          },
-          "installed_version": { "type": "string", "example": "3.2.0" }
-        },
-        "required": ["verifiable_password_authentication"]
+          "message": { "type": "string" },
+          "documentation_url": { "type": "string" },
+          "errors": { "type": "array", "items": { "type": "string" } }
+        }
       },
       "org-pre-receive-hook": {
         "type": "object",
@@ -5451,6 +6185,17 @@
           "most_recent_instance"
         ]
       },
+      "code-scanning-alert-set-state": {
+        "description": "Sets the state of the code scanning alert. Can be one of `open` or `dismissed`. You must provide `dismissed_reason` when you set the state to `dismissed`.",
+        "type": "string",
+        "enum": ["open", "dismissed"]
+      },
+      "code-scanning-alert-dismissed-reason": {
+        "type": "string",
+        "description": "**Required when the state is dismissed.** The reason for dismissing or closing the alert. Can be one of: `false positive`, `won't fix`, and `used in tests`.",
+        "nullable": true,
+        "enum": [null, "false positive", "won't fix", "used in tests"]
+      },
       "code-scanning-ref": {
         "type": "string",
         "description": "The full Git reference, formatted as `refs/heads/<branch name>`,\n`refs/pull/<number>/merge`, or `refs/pull/<number>/head`."
@@ -6531,12 +7276,6 @@
         "readOnly": true,
         "nullable": true
       },
-      "code-scanning-alert-dismissed-reason": {
-        "type": "string",
-        "description": "**Required when the state is dismissed.** The reason for dismissing or closing the alert. Can be one of: `false positive`, `won't fix`, and `used in tests`.",
-        "nullable": true,
-        "enum": [null, "false positive", "won't fix", "used in tests"]
-      },
       "code-scanning-alert-rule": {
         "type": "object",
         "properties": {
@@ -7365,41 +8104,6 @@
           "html_url": { "type": "string", "format": "uri", "nullable": true }
         },
         "required": ["url", "html_url", "key", "name"]
-      },
-      "validation-error": {
-        "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", "nullable": true },
-                    { "type": "integer", "nullable": true },
-                    {
-                      "type": "array",
-                      "nullable": true,
-                      "items": { "type": "string" }
-                    }
-                  ]
-                }
-              }
-            }
-          }
-        }
       }
     },
     "examples": {
@@ -7962,6 +8666,56 @@
           "installed_version": "3.2.0"
         }
       },
+      "organization-full": {
+        "value": {
+          "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",
+          "twitter_username": "github",
+          "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",
+          "type": "Organization",
+          "total_private_repos": 100,
+          "owned_private_repos": 100,
+          "private_gists": 81,
+          "disk_usage": 10000,
+          "collaborators": 8,
+          "billing_email": "mona@github.com",
+          "plan": { "name": "Medium", "space": 400, "private_repos": 20 },
+          "default_repository_permission": "read",
+          "members_can_create_repositories": true,
+          "two_factor_requirement_enabled": true,
+          "members_allowed_repository_creation_type": "all",
+          "members_can_create_public_repositories": false,
+          "members_can_create_private_repositories": false,
+          "members_can_create_internal_repositories": false,
+          "members_can_create_pages": true,
+          "members_can_create_public_pages": true,
+          "members_can_create_private_pages": true,
+          "updated_at": "2014-03-03T18:58:10Z"
+        }
+      },
       "org-pre-receive-hook-items": {
         "value": [
           {
@@ -8255,6 +9009,67 @@
           "instances_url": "https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/42/instances"
         }
       },
+      "code-scanning-alert-dismissed": {
+        "value": {
+          "number": 42,
+          "created_at": "2020-08-25T21:28:36Z",
+          "url": "https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/42",
+          "html_url": "https://github.com/octocat/hello-world/code-scanning/42",
+          "state": "dismissed",
+          "dismissed_by": {
+            "login": "octocat",
+            "id": 1,
+            "node_id": "MDQ6VXNlcjE=",
+            "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+            "gravatar_id": "",
+            "url": "https://api.github.com/users/octocat",
+            "html_url": "https://github.com/octocat",
+            "followers_url": "https://api.github.com/users/octocat/followers",
+            "following_url": "https://api.github.com/users/octocat/following{/other_user}",
+            "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}",
+            "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}",
+            "subscriptions_url": "https://api.github.com/users/octocat/subscriptions",
+            "organizations_url": "https://api.github.com/users/octocat/orgs",
+            "repos_url": "https://api.github.com/users/octocat/repos",
+            "events_url": "https://api.github.com/users/octocat/events{/privacy}",
+            "received_events_url": "https://api.github.com/users/octocat/received_events",
+            "type": "User",
+            "site_admin": false
+          },
+          "dismissed_at": "2020-09-02T22:34:56Z",
+          "dismissed_reason": "false positive",
+          "rule": {
+            "id": "js/zipslip",
+            "severity": "error",
+            "security_severity_level": "high",
+            "description": "Arbitrary file write during zip extraction (\"Zip Slip\")",
+            "name": "js/zipslip",
+            "full_description": "Extracting files from a malicious zip archive without validating that the destination file path is within the destination directory can cause files outside the destination directory to be overwritten.",
+            "tags": ["security", "external/cwe/cwe-022"],
+            "help": "# Arbitrary file write during zip extraction (\"Zip Slip\")\\nExtracting files from a malicious zip archive without validating that the destination file path is within the destination directory can cause files outside the destination directory to be overwritten ..."
+          },
+          "tool": { "name": "CodeQL", "guid": null, "version": "2.4.0" },
+          "most_recent_instance": {
+            "ref": "refs/heads/main",
+            "analysis_key": ".github/workflows/codeql-analysis.yml:CodeQL-Build",
+            "environment": "{}",
+            "state": "dismissed",
+            "commit_sha": "39406e42cb832f683daa691dd652a8dc36ee8930",
+            "message": {
+              "text": "This path depends on a user-provided value."
+            },
+            "location": {
+              "path": "spec-main/api-session-spec.ts",
+              "start_line": 917,
+              "end_line": 917,
+              "start_column": 7,
+              "end_column": 18
+            },
+            "classifications": ["test"]
+          },
+          "instances_url": "https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/42/instances"
+        }
+      },
       "code-scanning-analysis-items": {
         "value": [
           {
@@ -8750,6 +9565,14 @@
         }
       },
       "not_modified": { "description": "Not modified" },
+      "conflict": {
+        "description": "Conflict",
+        "content": {
+          "application/json": {
+            "schema": { "$ref": "#/components/schemas/basic-error" }
+          }
+        }
+      },
       "code_scanning_forbidden_read": {
         "description": "Response if GitHub Advanced Security is not enabled for this repository",
         "content": {
@@ -8773,6 +9596,14 @@
           }
         }
       },
+      "code_scanning_forbidden_write": {
+        "description": "Response if the repository is archived or if github advanced security is not enabled for this repository",
+        "content": {
+          "application/json": {
+            "schema": { "$ref": "#/components/schemas/basic-error" }
+          }
+        }
+      },
       "validation_failed": {
         "description": "Validation failed",
         "content": {