@octokit/openapi 7.3.0 → 7.6.0

package/generated/api.github.com.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "7.3.0",
+    "version": "7.6.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": {
@@ -6926,7 +6926,7 @@
     "/organizations/{organization_id}/custom_roles": {
       "get": {
         "summary": "List custom repository roles in an organization",
-        "description": "List the custom repository roles available in this organization. In order to see custom\nrepository roles in an organization, the authenticated user must be an organization owner.\n\nFor more information on custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization)\".",
+        "description": "List the custom repository roles available in this organization. In order to see custom\nrepository roles in an organization, the authenticated user must be an organization owner.\n\nTo use this endpoint the authenticated user must be an administrator for the organization or of an repository of the organizaiton and must use an access token with `admin:org repo` scope.\nGitHub Apps must have the `organization_custom_roles:read` organization permission to use this endpoint.\n\nFor more information on custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization)\".",
         "tags": [
           "orgs"
         ],
@@ -6938,6 +6938,7 @@
         "parameters": [
           {
             "name": "organization_id",
+            "description": "The unique identifier of the organization.",
             "in": "path",
             "required": true,
             "schema": {
@@ -7145,6 +7146,11 @@
                     "description": "Whether organization members can fork private organization repositories.",
                     "default": false
                   },
+                  "web_commit_signoff_required": {
+                    "type": "boolean",
+                    "description": "Whether contributors to organization repositories are required to sign off on commits they make through GitHub's web interface.",
+                    "default": false
+                  },
                   "blog": {
                     "type": "string",
                     "example": "\"http://github.blog\""
@@ -14467,6 +14473,40 @@
                     "type": "boolean",
                     "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.",
                     "default": false
+                  },
+                  "squash_merge_commit_title": {
+                    "type": "string",
+                    "enum": [
+                      "PR_TITLE",
+                      "COMMIT_OR_PR_TITLE"
+                    ],
+                    "description": "The default value for a squash merge commit title:\n\n- `PR_TITLE` - default to the pull request's title.\n- `COMMIT_OR_PR_TITLE` - default to the commit's title (if only one commit) or the pull request's title (when more than one commit)."
+                  },
+                  "squash_merge_commit_message": {
+                    "type": "string",
+                    "enum": [
+                      "PR_BODY",
+                      "COMMIT_MESSAGES",
+                      "BLANK"
+                    ],
+                    "description": "The default value for a squash merge commit message:\n\n- `PR_BODY` - default to the pull request's body.\n- `COMMIT_MESSAGES` - default to the branch's commit messages.\n- `BLANK` - default to a blank commit message."
+                  },
+                  "merge_commit_title": {
+                    "type": "string",
+                    "enum": [
+                      "PR_TITLE",
+                      "MERGE_MESSAGE"
+                    ],
+                    "description": "The default value for a merge commit title.\n\n- `PR_TITLE` - default to the pull request's title.\n- `MERGE_MESSAGE` - default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name)."
+                  },
+                  "merge_commit_message": {
+                    "type": "string",
+                    "enum": [
+                      "PR_BODY",
+                      "PR_TITLE",
+                      "BLANK"
+                    ],
+                    "description": "The default value for a merge commit message.\n\n- `PR_TITLE` - default to the pull request's title.\n- `PR_BODY` - default to the pull request's body.\n- `BLANK` - default to a blank commit message."
                   }
                 },
                 "required": [
@@ -19304,6 +19344,40 @@
                     "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.",
                     "default": false
                   },
+                  "squash_merge_commit_title": {
+                    "type": "string",
+                    "enum": [
+                      "PR_TITLE",
+                      "COMMIT_OR_PR_TITLE"
+                    ],
+                    "description": "The default value for a squash merge commit title:\n\n- `PR_TITLE` - default to the pull request's title.\n- `COMMIT_OR_PR_TITLE` - default to the commit's title (if only one commit) or the pull request's title (when more than one commit)."
+                  },
+                  "squash_merge_commit_message": {
+                    "type": "string",
+                    "enum": [
+                      "PR_BODY",
+                      "COMMIT_MESSAGES",
+                      "BLANK"
+                    ],
+                    "description": "The default value for a squash merge commit message:\n\n- `PR_BODY` - default to the pull request's body.\n- `COMMIT_MESSAGES` - default to the branch's commit messages.\n- `BLANK` - default to a blank commit message."
+                  },
+                  "merge_commit_title": {
+                    "type": "string",
+                    "enum": [
+                      "PR_TITLE",
+                      "MERGE_MESSAGE"
+                    ],
+                    "description": "The default value for a merge commit title.\n\n- `PR_TITLE` - default to the pull request's title.\n- `MERGE_MESSAGE` - default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name)."
+                  },
+                  "merge_commit_message": {
+                    "type": "string",
+                    "enum": [
+                      "PR_BODY",
+                      "PR_TITLE",
+                      "BLANK"
+                    ],
+                    "description": "The default value for a merge commit message.\n\n- `PR_TITLE` - default to the pull request's title.\n- `PR_BODY` - default to the pull request's body.\n- `BLANK` - default to a blank commit message."
+                  },
                   "archived": {
                     "type": "boolean",
                     "description": "`true` to archive this repository. **Note**: You cannot unarchive repositories through the API.",
@@ -19313,6 +19387,11 @@
                     "type": "boolean",
                     "description": "Either `true` to allow private forks, or `false` to prevent private forks.",
                     "default": false
+                  },
+                  "web_commit_signoff_required": {
+                    "type": "boolean",
+                    "description": "Either `true` to require contributors to sign off on web-based commits, or `false` to not require contributors to sign off on web-based commits.",
+                    "default": false
                   }
                 }
               },
@@ -19977,6 +20056,11 @@
                     "description": "Whether to enable debug logging for the re-run."
                   }
                 }
+              },
+              "examples": {
+                "default": {
+                  "value": null
+                }
               }
             }
           }
@@ -21674,9 +21758,12 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "object",
-                  "properties": {},
-                  "additionalProperties": false
+                  "$ref": "#/components/schemas/empty-object"
+                },
+                "examples": {
+                  "default": {
+                    "value": null
+                  }
                 }
               }
             }
@@ -21981,6 +22068,17 @@
                   "state",
                   "comment"
                 ]
+              },
+              "examples": {
+                "default": {
+                  "value": {
+                    "environment_ids": [
+                      161171787
+                    ],
+                    "state": "approved",
+                    "comment": "Ship it!"
+                  }
+                }
               }
             }
           }
@@ -22051,6 +22149,11 @@
                     "description": "Whether to enable debug logging for the re-run."
                   }
                 }
+              },
+              "examples": {
+                "default": {
+                  "value": null
+                }
               }
             }
           }
@@ -22061,9 +22164,12 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "object",
-                  "properties": {},
-                  "additionalProperties": false
+                  "$ref": "#/components/schemas/empty-object"
+                },
+                "examples": {
+                  "default": {
+                    "value": null
+                  }
                 }
               }
             }
@@ -22115,6 +22221,11 @@
                     "description": "Whether to enable debug logging for the re-run."
                   }
                 }
+              },
+              "examples": {
+                "default": {
+                  "value": null
+                }
               }
             }
           }
@@ -22417,9 +22528,12 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "object",
-                  "properties": {},
-                  "additionalProperties": false
+                  "$ref": "#/components/schemas/empty-object"
+                },
+                "examples": {
+                  "default": {
+                    "value": null
+                  }
                 }
               }
             }
@@ -23399,6 +23513,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/branch-with-protection"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/branch-get"
+                  }
                 }
               }
             }
@@ -23741,6 +23860,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/protected-branch"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/branch-protection-update"
+                  }
                 }
               }
             }
@@ -24615,7 +24739,7 @@
                     "properties": {
                       "contexts": {
                         "type": "array",
-                        "description": "contexts parameter",
+                        "description": "The name of the status checks",
                         "items": {
                           "type": "string"
                         }
@@ -24631,6 +24755,17 @@
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example adding status checks to a branch protection rule",
+                  "value": {
+                    "contexts": [
+                      "continuous-integration/travis-ci",
+                      "continuous-integration/jenkins"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -24709,7 +24844,7 @@
                     "properties": {
                       "contexts": {
                         "type": "array",
-                        "description": "contexts parameter",
+                        "description": "The name of the status checks",
                         "items": {
                           "type": "string"
                         }
@@ -24725,6 +24860,16 @@
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example updating status checks for a branch protection rule",
+                  "value": {
+                    "contexts": [
+                      "continuous-integration/travis-ci"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -24798,7 +24943,7 @@
                     "properties": {
                       "contexts": {
                         "type": "array",
-                        "description": "contexts parameter",
+                        "description": "The name of the status checks",
                         "items": {
                           "type": "string"
                         }
@@ -24814,6 +24959,16 @@
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example removing status checks from a branch protection rule",
+                  "value": {
+                    "contexts": [
+                      "continuous-integration/travis-ci"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -25339,7 +25494,7 @@
                     "properties": {
                       "teams": {
                         "type": "array",
-                        "description": "teams parameter",
+                        "description": "The slug values for teams",
                         "items": {
                           "type": "string"
                         }
@@ -25355,6 +25510,16 @@
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example adding a team in a branch protection rule",
+                  "value": {
+                    "teams": [
+                      "justice-league"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -25424,7 +25589,7 @@
                     "properties": {
                       "teams": {
                         "type": "array",
-                        "description": "teams parameter",
+                        "description": "The slug values for teams",
                         "items": {
                           "type": "string"
                         }
@@ -25435,11 +25600,21 @@
                     ],
                     "example": {
                       "teams": [
-                        "my-team"
+                        "justice-league"
                       ]
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example replacing a team in a branch protection rule",
+                  "value": {
+                    "teams": [
+                      "justice-league"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -25508,7 +25683,7 @@
                     "properties": {
                       "teams": {
                         "type": "array",
-                        "description": "teams parameter",
+                        "description": "The slug values for teams",
                         "items": {
                           "type": "string"
                         }
@@ -25524,6 +25699,16 @@
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example removing a team in a branch protection rule",
+                  "value": {
+                    "teams": [
+                      "justice-league"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -25648,7 +25833,7 @@
                     "properties": {
                       "users": {
                         "type": "array",
-                        "description": "users parameter",
+                        "description": "The username for users",
                         "items": {
                           "type": "string"
                         }
@@ -25664,6 +25849,16 @@
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example adding a user in a branch protection rule",
+                  "value": {
+                    "users": [
+                      "octocat"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -25733,7 +25928,7 @@
                     "properties": {
                       "users": {
                         "type": "array",
-                        "description": "users parameter",
+                        "description": "The username for users",
                         "items": {
                           "type": "string"
                         }
@@ -25749,6 +25944,16 @@
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example replacing a user in a branch protection rule",
+                  "value": {
+                    "users": [
+                      "octocat"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -25817,7 +26022,7 @@
                     "properties": {
                       "users": {
                         "type": "array",
-                        "description": "users parameter",
+                        "description": "The username for users",
                         "items": {
                           "type": "string"
                         }
@@ -25833,6 +26038,16 @@
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example removing a user in a branch protection rule",
+                  "value": {
+                    "users": [
+                      "octocat"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -27548,71 +27763,21 @@
             "schema": {
               "$ref": "#/components/schemas/code-scanning-analysis-sarif-id"
             }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Response",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/code-scanning-analysis"
-                  }
-                },
-                "examples": {
-                  "default": {
-                    "$ref": "#/components/examples/code-scanning-analysis-items"
-                  }
-                }
-              }
-            }
-          },
-          "403": {
-            "$ref": "#/components/responses/code_scanning_forbidden_read"
           },
-          "404": {
-            "$ref": "#/components/responses/not_found"
-          },
-          "503": {
-            "$ref": "#/components/responses/service_unavailable"
-          }
-        },
-        "x-github": {
-          "enabledForGitHubApps": true,
-          "githubCloudOnly": false,
-          "category": "code-scanning"
-        },
-        "x-octokit": {}
-      }
-    },
-    "/repos/{owner}/{repo}/code-scanning/analyses/{analysis_id}": {
-      "get": {
-        "summary": "Get a code scanning analysis for a repository",
-        "description": "Gets a specified code scanning analysis for a repository.\nYou must use an access token with the `security_events` scope to use this endpoint with private repos,\nthe `public_repo` scope also grants permission to read security events on public repos only.\nGitHub Apps must have the `security_events` read permission to use this endpoint.\n\nThe default JSON response contains fields that describe the analysis.\nThis includes the Git reference and commit SHA to which the analysis relates,\nthe datetime of the analysis, the name of the code scanning tool,\nand the number of alerts.\n\nThe `rules_count` field in the default response give the number of rules\nthat were run in the analysis.\nFor very old analyses this data is not available,\nand `0` is returned in this field.\n\nIf you use the Accept header `application/sarif+json`,\nthe response contains the analysis data that was uploaded.\nThis is formatted as\n[SARIF version 2.1.0](https://docs.oasis-open.org/sarif/sarif/v2.1.0/cs01/sarif-v2.1.0-cs01.html).",
-        "operationId": "code-scanning/get-analysis",
-        "tags": [
-          "code-scanning"
-        ],
-        "externalDocs": {
-          "description": "API method documentation",
-          "url": "https://docs.github.com/rest/reference/code-scanning#get-a-code-scanning-analysis-for-a-repository"
-        },
-        "parameters": [
           {
-            "$ref": "#/components/parameters/owner"
-          },
-          {
-            "$ref": "#/components/parameters/repo"
+            "$ref": "#/components/parameters/direction"
           },
           {
-            "name": "analysis_id",
-            "in": "path",
-            "description": "The ID of the analysis, as returned from the `GET /repos/{owner}/{repo}/code-scanning/analyses` operation.",
-            "required": true,
+            "name": "sort",
+            "description": "The property by which to sort the results.",
+            "in": "query",
+            "required": false,
             "schema": {
-              "type": "integer"
+              "type": "string",
+              "enum": [
+                "created"
+              ],
+              "default": "created"
             }
           }
         ],
@@ -27622,22 +27787,88 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/code-scanning-analysis"
-                },
-                "examples": {
-                  "response": {
-                    "$ref": "#/components/examples/code-scanning-analysis-default"
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/code-scanning-analysis"
                   }
-                }
-              },
-              "application/json+sarif": {
-                "schema": {
-                  "type": "object",
-                  "additionalProperties": true
                 },
                 "examples": {
-                  "response": {
-                    "$ref": "#/components/examples/code-scanning-analysis-sarif"
+                  "default": {
+                    "$ref": "#/components/examples/code-scanning-analysis-items"
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "$ref": "#/components/responses/code_scanning_forbidden_read"
+          },
+          "404": {
+            "$ref": "#/components/responses/not_found"
+          },
+          "503": {
+            "$ref": "#/components/responses/service_unavailable"
+          }
+        },
+        "x-github": {
+          "enabledForGitHubApps": true,
+          "githubCloudOnly": false,
+          "category": "code-scanning"
+        },
+        "x-octokit": {}
+      }
+    },
+    "/repos/{owner}/{repo}/code-scanning/analyses/{analysis_id}": {
+      "get": {
+        "summary": "Get a code scanning analysis for a repository",
+        "description": "Gets a specified code scanning analysis for a repository.\nYou must use an access token with the `security_events` scope to use this endpoint with private repos,\nthe `public_repo` scope also grants permission to read security events on public repos only.\nGitHub Apps must have the `security_events` read permission to use this endpoint.\n\nThe default JSON response contains fields that describe the analysis.\nThis includes the Git reference and commit SHA to which the analysis relates,\nthe datetime of the analysis, the name of the code scanning tool,\nand the number of alerts.\n\nThe `rules_count` field in the default response give the number of rules\nthat were run in the analysis.\nFor very old analyses this data is not available,\nand `0` is returned in this field.\n\nIf you use the Accept header `application/sarif+json`,\nthe response contains the analysis data that was uploaded.\nThis is formatted as\n[SARIF version 2.1.0](https://docs.oasis-open.org/sarif/sarif/v2.1.0/cs01/sarif-v2.1.0-cs01.html).",
+        "operationId": "code-scanning/get-analysis",
+        "tags": [
+          "code-scanning"
+        ],
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/reference/code-scanning#get-a-code-scanning-analysis-for-a-repository"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/owner"
+          },
+          {
+            "$ref": "#/components/parameters/repo"
+          },
+          {
+            "name": "analysis_id",
+            "in": "path",
+            "description": "The ID of the analysis, as returned from the `GET /repos/{owner}/{repo}/code-scanning/analyses` operation.",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/code-scanning-analysis"
+                },
+                "examples": {
+                  "response": {
+                    "$ref": "#/components/examples/code-scanning-analysis-default"
+                  }
+                }
+              },
+              "application/json+sarif": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": true
+                },
+                "examples": {
+                  "response": {
+                    "$ref": "#/components/examples/code-scanning-analysis-sarif"
                   }
                 }
               }
@@ -27662,7 +27893,7 @@
       },
       "delete": {
         "summary": "Delete a code scanning analysis from a repository",
-        "description": "Deletes a specified code scanning analysis from a repository. For\nprivate repositories, you must use an access token with the `repo` scope. For public repositories,\nyou must use an access token with `public_repo` scope.\nGitHub Apps must have the `security_events` write permission to use this endpoint.\n\nYou can delete one analysis at a time.\nTo delete a series of analyses, start with the most recent analysis and work backwards.\nConceptually, the process is similar to the undo function in a text editor.\n\nWhen you list the analyses for a repository,\none or more will be identified as deletable in the response:\n\n```\n\"deletable\": true\n```\n\nAn analysis is deletable when it's the most recent in a set of analyses.\nTypically, a repository will have multiple sets of analyses\nfor each enabled code scanning tool,\nwhere a set is determined by a unique combination of analysis values:\n\n* `ref`\n* `tool`\n* `analysis_key`\n* `environment`\n\nIf you attempt to delete an analysis that is not the most recent in a set,\nyou'll get a 400 response with the message:\n\n```\nAnalysis specified is not deletable.\n```\n\nThe response from a successful `DELETE` operation provides you with\ntwo alternative URLs for deleting the next analysis in the set:\n`next_analysis_url` and `confirm_delete_url`.\nUse the `next_analysis_url` URL if you want to avoid accidentally deleting the final analysis\nin a set. This is a useful option if you want to preserve at least one analysis\nfor the specified tool in your repository.\nUse the `confirm_delete_url` URL if you are content to remove all analyses for a tool.\nWhen you delete the last analysis in a set, the value of `next_analysis_url` and `confirm_delete_url`\nin the 200 response is `null`.\n\nAs an example of the deletion process,\nlet's imagine that you added a workflow that configured a particular code scanning tool\nto analyze the code in a repository. This tool has added 15 analyses:\n10 on the default branch, and another 5 on a topic branch.\nYou therefore have two separate sets of analyses for this tool.\nYou've now decided that you want to remove all of the analyses for the tool.\nTo do this you must make 15 separate deletion requests.\nTo start, you must find an analysis that's identified as deletable.\nEach set of analyses always has one that's identified as deletable.\nHaving found the deletable analysis for one of the two sets,\ndelete this analysis and then continue deleting the next analysis in the set until they're all deleted.\nThen repeat the process for the second set.\nThe procedure therefore consists of a nested loop:\n\n**Outer loop**:\n* List the analyses for the repository, filtered by tool.\n* Parse this list to find a deletable analysis. If found:\n\n  **Inner loop**:\n  * Delete the identified analysis.\n  * Parse the response for the value of `confirm_delete_url` and, if found, use this in the next iteration.\n\nThe above process assumes that you want to remove all trace of the tool's analyses from the GitHub user interface, for the specified repository, and it therefore uses the `confirm_delete_url` value. Alternatively, you could use the `next_analysis_url` value, which would leave the last analysis in each set undeleted to avoid removing a tool's analysis entirely.",
+        "description": "Deletes a specified code scanning analysis from a repository. For\nprivate repositories, you must use an access token with the `repo` scope. For public repositories,\nyou must use an access token with `public_repo` scope.\nGitHub Apps must have the `security_events` write permission to use this endpoint.\n\nYou can delete one analysis at a time.\nTo delete a series of analyses, start with the most recent analysis and work backwards.\nConceptually, the process is similar to the undo function in a text editor.\n\nWhen you list the analyses for a repository,\none or more will be identified as deletable in the response:\n\n```\n\"deletable\": true\n```\n\nAn analysis is deletable when it's the most recent in a set of analyses.\nTypically, a repository will have multiple sets of analyses\nfor each enabled code scanning tool,\nwhere a set is determined by a unique combination of analysis values:\n\n* `ref`\n* `tool`\n* `category`\n\nIf you attempt to delete an analysis that is not the most recent in a set,\nyou'll get a 400 response with the message:\n\n```\nAnalysis specified is not deletable.\n```\n\nThe response from a successful `DELETE` operation provides you with\ntwo alternative URLs for deleting the next analysis in the set:\n`next_analysis_url` and `confirm_delete_url`.\nUse the `next_analysis_url` URL if you want to avoid accidentally deleting the final analysis\nin a set. This is a useful option if you want to preserve at least one analysis\nfor the specified tool in your repository.\nUse the `confirm_delete_url` URL if you are content to remove all analyses for a tool.\nWhen you delete the last analysis in a set, the value of `next_analysis_url` and `confirm_delete_url`\nin the 200 response is `null`.\n\nAs an example of the deletion process,\nlet's imagine that you added a workflow that configured a particular code scanning tool\nto analyze the code in a repository. This tool has added 15 analyses:\n10 on the default branch, and another 5 on a topic branch.\nYou therefore have two separate sets of analyses for this tool.\nYou've now decided that you want to remove all of the analyses for the tool.\nTo do this you must make 15 separate deletion requests.\nTo start, you must find an analysis that's identified as deletable.\nEach set of analyses always has one that's identified as deletable.\nHaving found the deletable analysis for one of the two sets,\ndelete this analysis and then continue deleting the next analysis in the set until they're all deleted.\nThen repeat the process for the second set.\nThe procedure therefore consists of a nested loop:\n\n**Outer loop**:\n* List the analyses for the repository, filtered by tool.\n* Parse this list to find a deletable analysis. If found:\n\n  **Inner loop**:\n  * Delete the identified analysis.\n  * Parse the response for the value of `confirm_delete_url` and, if found, use this in the next iteration.\n\nThe above process assumes that you want to remove all trace of the tool's analyses from the GitHub user interface, for the specified repository, and it therefore uses the `confirm_delete_url` value. Alternatively, you could use the `next_analysis_url` value, which would leave the last analysis in each set undeleted to avoid removing a tool's analysis entirely.",
         "operationId": "code-scanning/delete-analysis",
         "tags": [
           "code-scanning"
@@ -30391,7 +30622,7 @@
     "/repos/{owner}/{repo}/contents/{path}": {
       "get": {
         "summary": "Get repository content",
-        "description": "Gets the contents of a file or directory in a repository. Specify the file path or directory in `:path`. If you omit\n`:path`, you will receive the contents of the repository's root directory. See the description below regarding what the API response includes for directories. \n\nFiles and symlinks support [a custom media type](https://docs.github.com/rest/reference/repos#custom-media-types) for\nretrieving the raw content or rendered HTML (when supported). All content types support [a custom media\ntype](https://docs.github.com/rest/reference/repos#custom-media-types) to ensure the content is returned in a consistent\nobject format.\n\n**Note**:\n*   To get a repository's contents recursively, you can [recursively get the tree](https://docs.github.com/rest/reference/git#trees).\n*   This API has an upper limit of 1,000 files for a directory. If you need to retrieve more files, use the [Git Trees\nAPI](https://docs.github.com/rest/reference/git#get-a-tree).\n\n#### Size limits\nIf the requested file's size is:\n* 1 MB or smaller: All features of this endpoint are supported.\n* Between 1-100 MB: Only the `raw` or `object` [custom media types](https://docs.github.com/rest/repos/contents#custom-media-types-for-repository-contents) are supported. Both will work as normal, except that when using the `object` media type, the `content` field will be an empty string and the `encoding` field will be `\"none\"`. To get the contents of these larger files, use the `raw` media type.\n * Greater than 100 MB: This endpoint is not supported.\n\n#### If the content is a directory\nThe response will be an array of objects, one object for each item in the directory.\nWhen listing the contents of a directory, submodules have their \"type\" specified as \"file\". Logically, the value\n_should_ be \"submodule\". This behavior exists in API v3 [for backwards compatibility purposes](https://git.io/v1YCW).\nIn the next major version of the API, the type will be returned as \"submodule\".\n\n#### If the content is a symlink \nIf the requested `:path` points to a symlink, and the symlink's target is a normal file in the repository, then the\nAPI responds with the content of the file (in the format shown in the example. Otherwise, the API responds with an object \ndescribing the symlink itself.\n\n#### If the content is a submodule\nThe `submodule_git_url` identifies the location of the submodule repository, and the `sha` identifies a specific\ncommit within the submodule repository. Git uses the given URL when cloning the submodule repository, and checks out\nthe submodule at that specific commit.\n\nIf the submodule repository is not hosted on github.com, the Git URLs (`git_url` and `_links[\"git\"]`) and the\ngithub.com URLs (`html_url` and `_links[\"html\"]`) will have null values.",
+        "description": "Gets the contents of a file or directory in a repository. Specify the file path or directory in `:path`. If you omit\n`:path`, you will receive the contents of the repository's root directory. See the description below regarding what the API response includes for directories. \n\nFiles and symlinks support [a custom media type](https://docs.github.com/rest/reference/repos#custom-media-types) for\nretrieving the raw content or rendered HTML (when supported). All content types support [a custom media\ntype](https://docs.github.com/rest/reference/repos#custom-media-types) to ensure the content is returned in a consistent\nobject format.\n\n**Notes**:\n*   To get a repository's contents recursively, you can [recursively get the tree](https://docs.github.com/rest/reference/git#trees).\n*   This API has an upper limit of 1,000 files for a directory. If you need to retrieve more files, use the [Git Trees\nAPI](https://docs.github.com/rest/reference/git#get-a-tree).\n *  Download URLs expire and are meant to be used just once. To ensure the download URL does not expire, please use the contents API to obtain a fresh download URL for each download.\n#### Size limits\nIf the requested file's size is:\n* 1 MB or smaller: All features of this endpoint are supported.\n* Between 1-100 MB: Only the `raw` or `object` [custom media types](https://docs.github.com/rest/repos/contents#custom-media-types-for-repository-contents) are supported. Both will work as normal, except that when using the `object` media type, the `content` field will be an empty string and the `encoding` field will be `\"none\"`. To get the contents of these larger files, use the `raw` media type.\n * Greater than 100 MB: This endpoint is not supported.\n\n#### If the content is a directory\nThe response will be an array of objects, one object for each item in the directory.\nWhen listing the contents of a directory, submodules have their \"type\" specified as \"file\". Logically, the value\n_should_ be \"submodule\". This behavior exists in API v3 [for backwards compatibility purposes](https://git.io/v1YCW).\nIn the next major version of the API, the type will be returned as \"submodule\".\n\n#### If the content is a symlink \nIf the requested `:path` points to a symlink, and the symlink's target is a normal file in the repository, then the\nAPI responds with the content of the file (in the format shown in the example. Otherwise, the API responds with an object \ndescribing the symlink itself.\n\n#### If the content is a submodule\nThe `submodule_git_url` identifies the location of the submodule repository, and the `sha` identifies a specific\ncommit within the submodule repository. Git uses the given URL when cloning the submodule repository, and checks out\nthe submodule at that specific commit.\n\nIf the submodule repository is not hosted on github.com, the Git URLs (`git_url` and `_links[\"git\"]`) and the\ngithub.com URLs (`html_url` and `_links[\"html\"]`) will have null values.",
         "tags": [
           "repos"
         ],
@@ -32743,6 +32974,10 @@
                   "name": {
                     "type": "string",
                     "description": "When forking from an existing repository, a new name for the fork."
+                  },
+                  "default_branch_only": {
+                    "type": "boolean",
+                    "description": "When forking from an existing repository, fork with only the default branch."
                   }
                 }
               }
@@ -35408,6 +35643,15 @@
             "application/json": {
               "schema": {
                 "$ref": "#/components/schemas/interaction-limit"
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example request body",
+                  "value": {
+                    "limit": "collaborators_only",
+                    "expiry": "one_day"
+                  }
+                }
               }
             }
           }
@@ -35578,6 +35822,14 @@
                     ]
                   }
                 }
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example request body",
+                  "value": {
+                    "permissions": "write"
+                  }
+                }
               }
             }
           }
@@ -36673,6 +36925,12 @@
                       "closed"
                     ]
                   },
+                  "state_reason": {
+                    "type": "string",
+                    "nullable": true,
+                    "description": "The reason for the current state",
+                    "example": "not_planned"
+                  },
                   "milestone": {
                     "oneOf": [
                       {
@@ -56337,6 +56595,40 @@
                     "type": "boolean",
                     "example": false
                   },
+                  "squash_merge_commit_title": {
+                    "type": "string",
+                    "enum": [
+                      "PR_TITLE",
+                      "COMMIT_OR_PR_TITLE"
+                    ],
+                    "description": "The default value for a squash merge commit title:\n\n- `PR_TITLE` - default to the pull request's title.\n- `COMMIT_OR_PR_TITLE` - default to the commit's title (if only one commit) or the pull request's title (when more than one commit)."
+                  },
+                  "squash_merge_commit_message": {
+                    "type": "string",
+                    "enum": [
+                      "PR_BODY",
+                      "COMMIT_MESSAGES",
+                      "BLANK"
+                    ],
+                    "description": "The default value for a squash merge commit message:\n\n- `PR_BODY` - default to the pull request's body.\n- `COMMIT_MESSAGES` - default to the branch's commit messages.\n- `BLANK` - default to a blank commit message."
+                  },
+                  "merge_commit_title": {
+                    "type": "string",
+                    "enum": [
+                      "PR_TITLE",
+                      "MERGE_MESSAGE"
+                    ],
+                    "description": "The default value for a merge commit title.\n\n- `PR_TITLE` - default to the pull request's title.\n- `MERGE_MESSAGE` - default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name)."
+                  },
+                  "merge_commit_message": {
+                    "type": "string",
+                    "enum": [
+                      "PR_BODY",
+                      "PR_TITLE",
+                      "BLANK"
+                    ],
+                    "description": "The default value for a merge commit message.\n\n- `PR_TITLE` - default to the pull request's title.\n- `PR_BODY` - default to the pull request's body.\n- `BLANK` - default to a blank commit message."
+                  },
                   "has_downloads": {
                     "description": "Whether downloads are enabled.",
                     "default": true,
@@ -59823,14 +60115,6 @@
               "write"
             ]
           },
-          "organization_custom_roles": {
-            "type": "string",
-            "description": "The level of permission to grant the access token for custom roles management.",
-            "enum": [
-              "read",
-              "write"
-            ]
-          },
           "deployments": {
             "type": "string",
             "description": "The level of permission to grant the access token for deployments and deployment statuses.",
@@ -59975,6 +60259,14 @@
               "write"
             ]
           },
+          "organization_custom_roles": {
+            "type": "string",
+            "description": "The level of permission to grant the access token for custom roles management. This property is in beta and is subject to change.",
+            "enum": [
+              "read",
+              "write"
+            ]
+          },
           "organization_hooks": {
             "type": "string",
             "description": "The level of permission to grant the access token to manage the post-receive hooks for an organization.",
@@ -60914,6 +61206,40 @@
               "use_squash_pr_title_as_default": {
                 "type": "boolean"
               },
+              "squash_merge_commit_title": {
+                "type": "string",
+                "enum": [
+                  "PR_TITLE",
+                  "COMMIT_OR_PR_TITLE"
+                ],
+                "description": "The default value for a squash merge commit title:\n\n- `PR_TITLE` - default to the pull request's title.\n- `COMMIT_OR_PR_TITLE` - default to the commit's title (if only one commit) or the pull request's title (when more than one commit)."
+              },
+              "squash_merge_commit_message": {
+                "type": "string",
+                "enum": [
+                  "PR_BODY",
+                  "COMMIT_MESSAGES",
+                  "BLANK"
+                ],
+                "description": "The default value for a squash merge commit message:\n\n- `PR_BODY` - default to the pull request's body.\n- `COMMIT_MESSAGES` - default to the branch's commit messages.\n- `BLANK` - default to a blank commit message."
+              },
+              "merge_commit_title": {
+                "type": "string",
+                "enum": [
+                  "PR_TITLE",
+                  "MERGE_MESSAGE"
+                ],
+                "description": "The default value for a merge commit title.\n\n- `PR_TITLE` - default to the pull request's title.\n- `MERGE_MESSAGE` - default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name)."
+              },
+              "merge_commit_message": {
+                "type": "string",
+                "enum": [
+                  "PR_BODY",
+                  "PR_TITLE",
+                  "BLANK"
+                ],
+                "description": "The default value for a merge commit message.\n\n- `PR_TITLE` - default to the pull request's title.\n- `PR_BODY` - default to the pull request's body.\n- `BLANK` - default to a blank commit message."
+              },
               "allow_merge_commit": {
                 "type": "boolean"
               },
@@ -60957,6 +61283,40 @@
             "description": "Whether a squash merge commit can use the pull request title as default.",
             "default": false
           },
+          "squash_merge_commit_title": {
+            "type": "string",
+            "enum": [
+              "PR_TITLE",
+              "COMMIT_OR_PR_TITLE"
+            ],
+            "description": "The default value for a squash merge commit title:\n\n- `PR_TITLE` - default to the pull request's title.\n- `COMMIT_OR_PR_TITLE` - default to the commit's title (if only one commit) or the pull request's title (when more than one commit)."
+          },
+          "squash_merge_commit_message": {
+            "type": "string",
+            "enum": [
+              "PR_BODY",
+              "COMMIT_MESSAGES",
+              "BLANK"
+            ],
+            "description": "The default value for a squash merge commit message:\n\n- `PR_BODY` - default to the pull request's body.\n- `COMMIT_MESSAGES` - default to the branch's commit messages.\n- `BLANK` - default to a blank commit message."
+          },
+          "merge_commit_title": {
+            "type": "string",
+            "enum": [
+              "PR_TITLE",
+              "MERGE_MESSAGE"
+            ],
+            "description": "The default value for a merge commit title.\n\n- `PR_TITLE` - default to the pull request's title.\n- `MERGE_MESSAGE` - default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name)."
+          },
+          "merge_commit_message": {
+            "type": "string",
+            "enum": [
+              "PR_BODY",
+              "PR_TITLE",
+              "BLANK"
+            ],
+            "description": "The default value for a merge commit message.\n\n- `PR_TITLE` - default to the pull request's title.\n- `PR_BODY` - default to the pull request's body.\n- `BLANK` - default to a blank commit message."
+          },
           "allow_merge_commit": {
             "description": "Whether to allow merge commits for pull requests.",
             "default": true,
@@ -60967,6 +61327,11 @@
             "description": "Whether to allow forking this repo",
             "type": "boolean"
           },
+          "web_commit_signoff_required": {
+            "description": "Whether to require contributors to sign off on web-based commits",
+            "default": false,
+            "type": "boolean"
+          },
           "subscribers_count": {
             "type": "integer"
           },
@@ -65785,6 +66150,40 @@
               "use_squash_pr_title_as_default": {
                 "type": "boolean"
               },
+              "squash_merge_commit_title": {
+                "type": "string",
+                "enum": [
+                  "PR_TITLE",
+                  "COMMIT_OR_PR_TITLE"
+                ],
+                "description": "The default value for a squash merge commit title:\n\n- `PR_TITLE` - default to the pull request's title.\n- `COMMIT_OR_PR_TITLE` - default to the commit's title (if only one commit) or the pull request's title (when more than one commit)."
+              },
+              "squash_merge_commit_message": {
+                "type": "string",
+                "enum": [
+                  "PR_BODY",
+                  "COMMIT_MESSAGES",
+                  "BLANK"
+                ],
+                "description": "The default value for a squash merge commit message:\n\n- `PR_BODY` - default to the pull request's body.\n- `COMMIT_MESSAGES` - default to the branch's commit messages.\n- `BLANK` - default to a blank commit message."
+              },
+              "merge_commit_title": {
+                "type": "string",
+                "enum": [
+                  "PR_TITLE",
+                  "MERGE_MESSAGE"
+                ],
+                "description": "The default value for a merge commit title.\n\n- `PR_TITLE` - default to the pull request's title.\n- `MERGE_MESSAGE` - default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name)."
+              },
+              "merge_commit_message": {
+                "type": "string",
+                "enum": [
+                  "PR_BODY",
+                  "PR_TITLE",
+                  "BLANK"
+                ],
+                "description": "The default value for a merge commit message.\n\n- `PR_TITLE` - default to the pull request's title.\n- `PR_BODY` - default to the pull request's body.\n- `BLANK` - default to a blank commit message."
+              },
               "allow_merge_commit": {
                 "type": "boolean"
               },
@@ -65828,6 +66227,40 @@
             "description": "Whether a squash merge commit can use the pull request title as default.",
             "default": false
           },
+          "squash_merge_commit_title": {
+            "type": "string",
+            "enum": [
+              "PR_TITLE",
+              "COMMIT_OR_PR_TITLE"
+            ],
+            "description": "The default value for a squash merge commit title:\n\n- `PR_TITLE` - default to the pull request's title.\n- `COMMIT_OR_PR_TITLE` - default to the commit's title (if only one commit) or the pull request's title (when more than one commit)."
+          },
+          "squash_merge_commit_message": {
+            "type": "string",
+            "enum": [
+              "PR_BODY",
+              "COMMIT_MESSAGES",
+              "BLANK"
+            ],
+            "description": "The default value for a squash merge commit message:\n\n- `PR_BODY` - default to the pull request's body.\n- `COMMIT_MESSAGES` - default to the branch's commit messages.\n- `BLANK` - default to a blank commit message."
+          },
+          "merge_commit_title": {
+            "type": "string",
+            "enum": [
+              "PR_TITLE",
+              "MERGE_MESSAGE"
+            ],
+            "description": "The default value for a merge commit title.\n\n- `PR_TITLE` - default to the pull request's title.\n- `MERGE_MESSAGE` - default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name)."
+          },
+          "merge_commit_message": {
+            "type": "string",
+            "enum": [
+              "PR_BODY",
+              "PR_TITLE",
+              "BLANK"
+            ],
+            "description": "The default value for a merge commit message.\n\n- `PR_TITLE` - default to the pull request's title.\n- `PR_BODY` - default to the pull request's body.\n- `BLANK` - default to a blank commit message."
+          },
           "allow_merge_commit": {
             "description": "Whether to allow merge commits for pull requests.",
             "default": true,
@@ -65838,6 +66271,11 @@
             "description": "Whether to allow forking this repo",
             "type": "boolean"
           },
+          "web_commit_signoff_required": {
+            "description": "Whether to require contributors to sign off on web-based commits",
+            "default": false,
+            "type": "boolean"
+          },
           "subscribers_count": {
             "type": "integer"
           },
@@ -66307,6 +66745,10 @@
           },
           "allow_forking": {
             "type": "boolean"
+          },
+          "web_commit_signoff_required": {
+            "type": "boolean",
+            "example": false
           }
         },
         "required": [
@@ -66717,6 +67159,10 @@
             "example": false,
             "nullable": true
           },
+          "web_commit_signoff_required": {
+            "type": "boolean",
+            "example": false
+          },
           "updated_at": {
             "type": "string",
             "format": "date-time"
@@ -68472,6 +68918,10 @@
           },
           "allow_forking": {
             "type": "boolean"
+          },
+          "web_commit_signoff_required": {
+            "type": "boolean",
+            "example": false
           }
         },
         "required": [
@@ -68943,6 +69393,267 @@
           }
         }
       },
+      "team-organization": {
+        "title": "Team Organization",
+        "description": "Team Organization",
+        "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
+          },
+          "members_can_fork_private_repositories": {
+            "type": "boolean",
+            "example": false,
+            "nullable": true
+          },
+          "web_commit_signoff_required": {
+            "type": "boolean",
+            "example": false
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time"
+          }
+        },
+        "required": [
+          "login",
+          "url",
+          "id",
+          "node_id",
+          "repos_url",
+          "events_url",
+          "hooks_url",
+          "issues_url",
+          "members_url",
+          "public_members_url",
+          "avatar_url",
+          "description",
+          "html_url",
+          "has_organization_projects",
+          "has_repository_projects",
+          "public_repos",
+          "public_gists",
+          "followers",
+          "following",
+          "type",
+          "created_at",
+          "updated_at"
+        ]
+      },
       "team-full": {
         "title": "Full Team",
         "description": "Groups of organization members that gives permissions on specified repositories.",
@@ -69027,7 +69738,7 @@
             "example": "2017-08-17T12:37:15Z"
           },
           "organization": {
-            "$ref": "#/components/schemas/organization-full"
+            "$ref": "#/components/schemas/team-organization"
           },
           "ldap_dn": {
             "description": "Distinguished Name (DN) that team maps to within LDAP environment",
@@ -69823,6 +70534,12 @@
             "type": "boolean",
             "example": false
           },
+          "web_commit_signoff_required": {
+            "description": "Whether to require contributors to sign off on web-based commits",
+            "default": false,
+            "type": "boolean",
+            "example": false
+          },
           "subscribers_count": {
             "type": "integer"
           },
@@ -70593,10 +71310,52 @@
             "type": "boolean",
             "example": false
           },
+          "squash_merge_commit_title": {
+            "type": "string",
+            "example": "PR_TITLE",
+            "enum": [
+              "PR_TITLE",
+              "COMMIT_OR_PR_TITLE"
+            ],
+            "description": "The default value for a squash merge commit title:\n\n- `PR_TITLE` - default to the pull request's title.\n- `COMMIT_OR_PR_TITLE` - default to the commit's title (if only one commit) or the pull request's title (when more than one commit)."
+          },
+          "squash_merge_commit_message": {
+            "type": "string",
+            "example": "PR_BODY",
+            "enum": [
+              "PR_BODY",
+              "COMMIT_MESSAGES",
+              "BLANK"
+            ],
+            "description": "The default value for a squash merge commit message:\n\n- `PR_BODY` - default to the pull request's body.\n- `COMMIT_MESSAGES` - default to the branch's commit messages.\n- `BLANK` - default to a blank commit message."
+          },
+          "merge_commit_title": {
+            "type": "string",
+            "example": "PR_TITLE",
+            "enum": [
+              "PR_TITLE",
+              "MERGE_MESSAGE"
+            ],
+            "description": "The default value for a merge commit title.\n\n  - `PR_TITLE` - default to the pull request's title.\n  - `MERGE_MESSAGE` - default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name)."
+          },
+          "merge_commit_message": {
+            "type": "string",
+            "example": "PR_BODY",
+            "enum": [
+              "PR_BODY",
+              "PR_TITLE",
+              "BLANK"
+            ],
+            "description": "The default value for a merge commit message.\n\n- `PR_TITLE` - default to the pull request's title.\n- `PR_BODY` - default to the pull request's body.\n- `BLANK` - default to a blank commit message."
+          },
           "allow_forking": {
             "type": "boolean",
             "example": true
           },
+          "web_commit_signoff_required": {
+            "type": "boolean",
+            "example": false
+          },
           "subscribers_count": {
             "type": "integer",
             "example": 42
@@ -81373,6 +82132,9 @@
                   },
                   "is_template": {
                     "type": "boolean"
+                  },
+                  "web_commit_signoff_required": {
+                    "type": "boolean"
                   }
                 },
                 "required": [
@@ -81947,6 +82709,9 @@
                   },
                   "allow_forking": {
                     "type": "boolean"
+                  },
+                  "web_commit_signoff_required": {
+                    "type": "boolean"
                   }
                 },
                 "required": [
@@ -84736,6 +85501,10 @@
           },
           "is_template": {
             "type": "boolean"
+          },
+          "web_commit_signoff_required": {
+            "type": "boolean",
+            "example": false
           }
         },
         "required": [
@@ -90850,6 +91619,7 @@
           "members_can_create_public_pages": true,
           "members_can_create_private_pages": true,
           "members_can_fork_private_repositories": false,
+          "web_commit_signoff_required": false,
           "updated_at": "2014-03-03T18:58:10Z"
         }
       },
@@ -95274,6 +96044,7 @@
           "delete_branch_on_merge": true,
           "allow_merge_commit": true,
           "allow_forking": true,
+          "web_commit_signoff_required": false,
           "subscribers_count": 42,
           "network_count": 0,
           "organization": {
@@ -96648,6 +97419,109 @@
           }
         ]
       },
+      "branch-get": {
+        "value": {
+          "name": "main",
+          "commit": {
+            "sha": "7fd1a60b01f91b314f59955a4e4d4e80d8edf11d",
+            "node_id": "MDY6Q29tbWl0MTI5NjI2OTo3ZmQxYTYwYjAxZjkxYjMxNGY1OTk1NWE0ZTRkNGU4MGQ4ZWRmMTFk",
+            "commit": {
+              "author": {
+                "name": "The Octocat",
+                "email": "octocat@nowhere.com",
+                "date": "2012-03-06T23:06:50Z"
+              },
+              "committer": {
+                "name": "The Octocat",
+                "email": "octocat@nowhere.com",
+                "date": "2012-03-06T23:06:50Z"
+              },
+              "message": "Merge pull request #6 from Spaceghost/patch-1\n\nNew line at end of file.",
+              "tree": {
+                "sha": "b4eecafa9be2f2006ce1b709d6857b07069b4608",
+                "url": "https://api.github.com/repos/octocat/Hello-World/git/trees/b4eecafa9be2f2006ce1b709d6857b07069b4608"
+              },
+              "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7fd1a60b01f91b314f59955a4e4d4e80d8edf11d",
+              "comment_count": 77,
+              "verification": {
+                "verified": false,
+                "reason": "unsigned",
+                "signature": null,
+                "payload": null
+              }
+            },
+            "url": "https://api.github.com/repos/octocat/Hello-World/commits/7fd1a60b01f91b314f59955a4e4d4e80d8edf11d",
+            "html_url": "https://github.com/octocat/Hello-World/commit/7fd1a60b01f91b314f59955a4e4d4e80d8edf11d",
+            "comments_url": "https://api.github.com/repos/octocat/Hello-World/commits/7fd1a60b01f91b314f59955a4e4d4e80d8edf11d/comments",
+            "author": {
+              "login": "octocat",
+              "id": 583231,
+              "node_id": "MDQ6VXNlcjU4MzIzMQ==",
+              "avatar_url": "https://avatars.githubusercontent.com/u/583231?v=4",
+              "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
+            },
+            "committer": {
+              "login": "octocat",
+              "id": 583231,
+              "node_id": "MDQ6VXNlcjU4MzIzMQ==",
+              "avatar_url": "https://avatars.githubusercontent.com/u/583231?v=4",
+              "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
+            },
+            "parents": [
+              {
+                "sha": "553c2077f0edc3d5dc5d17262f6aa498e69d6f8e",
+                "url": "https://api.github.com/repos/octocat/Hello-World/commits/553c2077f0edc3d5dc5d17262f6aa498e69d6f8e",
+                "html_url": "https://github.com/octocat/Hello-World/commit/553c2077f0edc3d5dc5d17262f6aa498e69d6f8e"
+              },
+              {
+                "sha": "762941318ee16e59dabbacb1b4049eec22f0d303",
+                "url": "https://api.github.com/repos/octocat/Hello-World/commits/762941318ee16e59dabbacb1b4049eec22f0d303",
+                "html_url": "https://github.com/octocat/Hello-World/commit/762941318ee16e59dabbacb1b4049eec22f0d303"
+              }
+            ]
+          },
+          "_links": {
+            "self": "https://api.github.com/repos/octocat/Hello-World/branches/main",
+            "html": "https://github.com/octocat/Hello-World/tree/main"
+          },
+          "protected": false,
+          "protection": {
+            "enabled": false,
+            "required_status_checks": {
+              "enforcement_level": "off",
+              "contexts": [],
+              "checks": []
+            }
+          },
+          "protection_url": "https://api.github.com/repos/octocat/Hello-World/branches/main/protection"
+        }
+      },
       "branch-protection": {
         "value": {
           "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection",
@@ -96844,6 +97718,71 @@
           }
         }
       },
+      "branch-protection-update": {
+        "value": {
+          "url": "https://api.github.com/repos/octocat/hello-world/branches/main/protection",
+          "required_status_checks": {
+            "url": "https://api.github.com/repos/octocat/hello-world/branches/main/protection/required_status_checks",
+            "strict": true,
+            "contexts": [
+              "continuous-integration/travis-ci"
+            ],
+            "contexts_url": "https://api.github.com/repos/octocat/hello-world/branches/main/protection/required_status_checks/contexts",
+            "checks": [
+              {
+                "context": "continuous-integration/travis-ci",
+                "app_id": null
+              }
+            ]
+          },
+          "restrictions": {
+            "url": "https://api.github.com/repos/octocat/hello-world/branches/main/protection/restrictions",
+            "users_url": "https://api.github.com/repos/octocat/hello-world/branches/main/protection/restrictions/users",
+            "teams_url": "https://api.github.com/repos/octocat/hello-world/branches/main/protection/restrictions/teams",
+            "apps_url": "https://api.github.com/repos/octocat/hello-world/branches/main/protection/restrictions/apps",
+            "users": [],
+            "teams": [],
+            "apps": []
+          },
+          "required_pull_request_reviews": {
+            "url": "https://api.github.com/repos/octocat/hello-world/branches/main/protection/required_pull_request_reviews",
+            "dismiss_stale_reviews": true,
+            "require_code_owner_reviews": true,
+            "required_approving_review_count": 2,
+            "dismissal_restrictions": {
+              "url": "https://api.github.com/repos/octocat/hello-world/branches/main/protection/dismissal_restrictions",
+              "users_url": "https://api.github.com/repos/octocat/hello-world/branches/main/protection/dismissal_restrictions/users",
+              "teams_url": "https://api.github.com/repos/octocat/hello-world/branches/main/protection/dismissal_restrictions/teams",
+              "users": [],
+              "teams": [],
+              "apps": []
+            }
+          },
+          "required_signatures": {
+            "url": "https://api.github.com/repos/octocat/hello-world/branches/main/protection/required_signatures",
+            "enabled": false
+          },
+          "enforce_admins": {
+            "url": "https://api.github.com/repos/octocat/hello-world/branches/main/protection/enforce_admins",
+            "enabled": true
+          },
+          "required_linear_history": {
+            "enabled": true
+          },
+          "allow_force_pushes": {
+            "enabled": true
+          },
+          "allow_deletions": {
+            "enabled": true
+          },
+          "block_creations": {
+            "enabled": true
+          },
+          "required_conversation_resolution": {
+            "enabled": true
+          }
+        }
+      },
       "protected-branch-admin-enforced-2": {
         "value": {
           "url": "https://api.github.com/repos/octocat/Hello-World/branches/master/protection/enforce_admins",
@@ -98385,6 +99324,7 @@
             "ref": "refs/heads/main",
             "analysis_key": ".github/workflows/codeql-analysis.yml:CodeQL-Build",
             "environment": "",
+            "category": ".github/workflows/codeql-analysis.yml:CodeQL-Build",
             "state": "open",
             "fixed_at": null,
             "commit_sha": "39406e42cb832f683daa691dd652a8dc36ee8930",
@@ -102337,7 +103277,8 @@
               "type": "User",
               "site_admin": false
             },
-            "author_association": "COLLABORATOR"
+            "author_association": "COLLABORATOR",
+            "state_reason": "completed"
           }
         ]
       },
@@ -102497,7 +103438,8 @@
             "type": "User",
             "site_admin": false
           },
-          "author_association": "COLLABORATOR"
+          "author_association": "COLLABORATOR",
+          "state_reason": "completed"
         }
       },
       "issue-comment-items": {
@@ -102733,7 +103675,8 @@
               "closed_at": null,
               "created_at": "2011-04-22T13:33:48Z",
               "updated_at": "2011-04-22T13:33:48Z",
-              "author_association": "COLLABORATOR"
+              "author_association": "COLLABORATOR",
+              "state_reason": "completed"
             }
           }
         ]
@@ -102942,7 +103885,8 @@
             "closed_at": null,
             "created_at": "2011-04-22T13:33:48Z",
             "updated_at": "2011-04-22T13:33:48Z",
-            "author_association": "COLLABORATOR"
+            "author_association": "COLLABORATOR",
+            "state_reason": "completed"
           }
         }
       },
@@ -107916,7 +108860,8 @@
               "body": "...",
               "score": 1,
               "locked": true,
-              "author_association": "COLLABORATOR"
+              "author_association": "COLLABORATOR",
+              "state_reason": "completed"
             }
           ]
         }