@octokit/openapi 7.3.0 → 7.6.0

package/generated/github.ae.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": {
@@ -2123,7 +2123,13 @@
           "category": "apps",
           "subcategory": null
         },
-        "x-octokit": {}
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
       }
     },
     "/app/installations/{installation_id}": {
@@ -2169,7 +2175,13 @@
           "category": "apps",
           "subcategory": null
         },
-        "x-octokit": {}
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
       },
       "delete": {
         "summary": "Delete an installation for the authenticated app",
@@ -2507,7 +2519,13 @@
           "category": "apps",
           "subcategory": "oauth-applications"
         },
-        "x-octokit": {}
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
       },
       "patch": {
         "summary": "Reset a token",
@@ -2577,7 +2595,13 @@
           "category": "apps",
           "subcategory": "oauth-applications"
         },
-        "x-octokit": {}
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
       },
       "delete": {
         "summary": "Delete an app token",
@@ -7456,6 +7480,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\""
@@ -10057,7 +10086,13 @@
           "category": "apps",
           "subcategory": null
         },
-        "x-octokit": {}
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
       }
     },
     "/orgs/{org}/installations": {
@@ -10126,7 +10161,13 @@
           "category": "orgs",
           "subcategory": null
         },
-        "x-octokit": {}
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
       }
     },
     "/orgs/{org}/issues": {
@@ -11489,6 +11530,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": [
@@ -15701,6 +15776,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.",
@@ -15710,6 +15819,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
                   }
                 }
               },
@@ -17142,9 +17256,12 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "object",
-                  "properties": {},
-                  "additionalProperties": false
+                  "$ref": "#/components/schemas/empty-object"
+                },
+                "examples": {
+                  "default": {
+                    "value": null
+                  }
                 }
               }
             }
@@ -17367,6 +17484,11 @@
               "schema": {
                 "type": "object",
                 "nullable": true
+              },
+              "examples": {
+                "default": {
+                  "value": null
+                }
               }
             }
           }
@@ -17377,9 +17499,12 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "object",
-                  "properties": {},
-                  "additionalProperties": false
+                  "$ref": "#/components/schemas/empty-object"
+                },
+                "examples": {
+                  "default": {
+                    "value": null
+                  }
                 }
               }
             }
@@ -17672,9 +17797,12 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "type": "object",
-                  "properties": {},
-                  "additionalProperties": false
+                  "$ref": "#/components/schemas/empty-object"
+                },
+                "examples": {
+                  "default": {
+                    "value": null
+                  }
                 }
               }
             }
@@ -18609,6 +18737,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/branch-with-protection"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/branch-get"
+                  }
                 }
               }
             }
@@ -18951,6 +19084,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/protected-branch"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/branch-protection-update"
+                  }
                 }
               }
             }
@@ -19825,7 +19963,7 @@
                     "properties": {
                       "contexts": {
                         "type": "array",
-                        "description": "contexts parameter",
+                        "description": "The name of the status checks",
                         "items": {
                           "type": "string"
                         }
@@ -19841,6 +19979,17 @@
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example adding status checks to a branch protection rule",
+                  "value": {
+                    "contexts": [
+                      "continuous-integration/travis-ci",
+                      "continuous-integration/jenkins"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -19919,7 +20068,7 @@
                     "properties": {
                       "contexts": {
                         "type": "array",
-                        "description": "contexts parameter",
+                        "description": "The name of the status checks",
                         "items": {
                           "type": "string"
                         }
@@ -19935,6 +20084,16 @@
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example updating status checks for a branch protection rule",
+                  "value": {
+                    "contexts": [
+                      "continuous-integration/travis-ci"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -20008,7 +20167,7 @@
                     "properties": {
                       "contexts": {
                         "type": "array",
-                        "description": "contexts parameter",
+                        "description": "The name of the status checks",
                         "items": {
                           "type": "string"
                         }
@@ -20024,6 +20183,16 @@
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example removing status checks from a branch protection rule",
+                  "value": {
+                    "contexts": [
+                      "continuous-integration/travis-ci"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -20549,7 +20718,7 @@
                     "properties": {
                       "teams": {
                         "type": "array",
-                        "description": "teams parameter",
+                        "description": "The slug values for teams",
                         "items": {
                           "type": "string"
                         }
@@ -20565,6 +20734,16 @@
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example adding a team in a branch protection rule",
+                  "value": {
+                    "teams": [
+                      "justice-league"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -20634,7 +20813,7 @@
                     "properties": {
                       "teams": {
                         "type": "array",
-                        "description": "teams parameter",
+                        "description": "The slug values for teams",
                         "items": {
                           "type": "string"
                         }
@@ -20645,11 +20824,21 @@
                     ],
                     "example": {
                       "teams": [
-                        "my-team"
+                        "justice-league"
                       ]
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example replacing a team in a branch protection rule",
+                  "value": {
+                    "teams": [
+                      "justice-league"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -20718,7 +20907,7 @@
                     "properties": {
                       "teams": {
                         "type": "array",
-                        "description": "teams parameter",
+                        "description": "The slug values for teams",
                         "items": {
                           "type": "string"
                         }
@@ -20734,6 +20923,16 @@
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example removing a team in a branch protection rule",
+                  "value": {
+                    "teams": [
+                      "justice-league"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -20858,7 +21057,7 @@
                     "properties": {
                       "users": {
                         "type": "array",
-                        "description": "users parameter",
+                        "description": "The username for users",
                         "items": {
                           "type": "string"
                         }
@@ -20874,6 +21073,16 @@
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example adding a user in a branch protection rule",
+                  "value": {
+                    "users": [
+                      "octocat"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -20943,7 +21152,7 @@
                     "properties": {
                       "users": {
                         "type": "array",
-                        "description": "users parameter",
+                        "description": "The username for users",
                         "items": {
                           "type": "string"
                         }
@@ -20959,6 +21168,16 @@
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example replacing a user in a branch protection rule",
+                  "value": {
+                    "users": [
+                      "octocat"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -21027,7 +21246,7 @@
                     "properties": {
                       "users": {
                         "type": "array",
-                        "description": "users parameter",
+                        "description": "The username for users",
                         "items": {
                           "type": "string"
                         }
@@ -21043,6 +21262,16 @@
                     }
                   }
                 ]
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example removing a user in a branch protection rule",
+                  "value": {
+                    "users": [
+                      "octocat"
+                    ]
+                  }
+                }
               }
             }
           }
@@ -22682,6 +22911,22 @@
             "schema": {
               "$ref": "#/components/schemas/code-scanning-analysis-sarif-id"
             }
+          },
+          {
+            "$ref": "#/components/parameters/direction"
+          },
+          {
+            "name": "sort",
+            "description": "The property by which to sort the results.",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "created"
+              ],
+              "default": "created"
+            }
           }
         ],
         "responses": {
@@ -24773,7 +25018,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/github-ae@latest/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/github-ae@latest/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/github-ae@latest/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/github-ae@latest/rest/reference/git#get-a-tree).\n*   This API supports files up to 1 megabyte in size.\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/github-ae@latest/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/github-ae@latest/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/github-ae@latest/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/github-ae@latest/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*   This API supports files up to 1 megabyte in size.\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"
         ],
@@ -28719,7 +28964,13 @@
           "category": "apps",
           "subcategory": null
         },
-        "x-octokit": {}
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
       }
     },
     "/repos/{owner}/{repo}/invitations": {
@@ -28830,6 +29081,14 @@
                     ]
                   }
                 }
+              },
+              "examples": {
+                "default": {
+                  "summary": "Example request body",
+                  "value": {
+                    "permissions": "write"
+                  }
+                }
               }
             }
           }
@@ -29979,6 +30238,12 @@
                       "closed"
                     ]
                   },
+                  "state_reason": {
+                    "type": "string",
+                    "nullable": true,
+                    "description": "The reason for the current state",
+                    "example": "not_planned"
+                  },
                   "milestone": {
                     "oneOf": [
                       {
@@ -42474,7 +42739,13 @@
           "category": "apps",
           "subcategory": "installations"
         },
-        "x-octokit": {}
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
       }
     },
     "/user/installations/{installation_id}/repositories": {
@@ -44002,6 +44273,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,
@@ -45248,7 +45553,13 @@
           "category": "apps",
           "subcategory": null
         },
-        "x-octokit": {}
+        "x-octokit": {
+          "diff": {
+            "api.github.com": {
+              "type": "changed"
+            }
+          }
+        }
       }
     },
     "/users/{username}/keys": {
@@ -51961,14 +52272,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.",
@@ -53954,6 +54257,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"
           },
@@ -57209,6 +57517,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"
           },
@@ -57678,6 +57991,10 @@
           },
           "allow_forking": {
             "type": "boolean"
+          },
+          "web_commit_signoff_required": {
+            "type": "boolean",
+            "example": false
           }
         },
         "required": [
@@ -58069,6 +58386,10 @@
             "example": false,
             "nullable": true
           },
+          "web_commit_signoff_required": {
+            "type": "boolean",
+            "example": false
+          },
           "updated_at": {
             "type": "string",
             "format": "date-time"
@@ -58922,6 +59243,267 @@
           "parent"
         ]
       },
+      "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.",
@@ -59006,7 +59588,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",
@@ -59802,6 +60384,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"
           },
@@ -60573,6 +61161,10 @@
             "type": "boolean",
             "example": true
           },
+          "web_commit_signoff_required": {
+            "type": "boolean",
+            "example": false
+          },
           "subscribers_count": {
             "type": "integer",
             "example": 42
@@ -70590,6 +71182,9 @@
                   },
                   "is_template": {
                     "type": "boolean"
+                  },
+                  "web_commit_signoff_required": {
+                    "type": "boolean"
                   }
                 },
                 "required": [
@@ -71164,6 +71759,9 @@
                   },
                   "allow_forking": {
                     "type": "boolean"
+                  },
+                  "web_commit_signoff_required": {
+                    "type": "boolean"
                   }
                 },
                 "required": [
@@ -73272,6 +73870,10 @@
           },
           "is_template": {
             "type": "boolean"
+          },
+          "web_commit_signoff_required": {
+            "type": "boolean",
+            "example": false
           }
         },
         "required": [
@@ -78366,6 +78968,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"
         }
       },
@@ -81524,6 +82127,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": {
@@ -82724,6 +83328,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",
@@ -82920,6 +83627,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",
@@ -87649,7 +88421,8 @@
               "type": "User",
               "site_admin": false
             },
-            "author_association": "COLLABORATOR"
+            "author_association": "COLLABORATOR",
+            "state_reason": "completed"
           }
         ]
       },
@@ -87809,7 +88582,8 @@
             "type": "User",
             "site_admin": false
           },
-          "author_association": "COLLABORATOR"
+          "author_association": "COLLABORATOR",
+          "state_reason": "completed"
         }
       },
       "issue-comment-items": {
@@ -88045,7 +88819,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"
             }
           }
         ]
@@ -88254,7 +89029,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"
           }
         }
       },
@@ -92433,7 +93209,8 @@
               "body": "...",
               "score": 1,
               "locked": true,
-              "author_association": "COLLABORATOR"
+              "author_association": "COLLABORATOR",
+              "state_reason": "completed"
             }
           ]
         }