@octokit/openapi 7.2.0 → 7.5.0

package/generated/api.github.com.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "7.2.0",
+    "version": "7.5.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": {
@@ -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
+                  }
                 }
               }
             }
@@ -56337,6 +56451,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,6 +59971,14 @@
               "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.",
@@ -60906,6 +61062,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"
               },
@@ -60949,6 +61139,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,
@@ -60959,6 +61183,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"
           },
@@ -65777,6 +66006,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"
               },
@@ -65820,6 +66083,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,
@@ -65830,6 +66127,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"
           },
@@ -66299,6 +66601,10 @@
           },
           "allow_forking": {
             "type": "boolean"
+          },
+          "web_commit_signoff_required": {
+            "type": "boolean",
+            "example": false
           }
         },
         "required": [
@@ -66709,6 +67015,10 @@
             "example": false,
             "nullable": true
           },
+          "web_commit_signoff_required": {
+            "type": "boolean",
+            "example": false
+          },
           "updated_at": {
             "type": "string",
             "format": "date-time"
@@ -68464,6 +68774,10 @@
           },
           "allow_forking": {
             "type": "boolean"
+          },
+          "web_commit_signoff_required": {
+            "type": "boolean",
+            "example": false
           }
         },
         "required": [
@@ -69815,6 +70129,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"
           },
@@ -70585,10 +70905,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
@@ -76340,8 +76702,6 @@
         }
       },
       "dependency": {
-        "title": "Dependency",
-        "description": "A single package dependency.",
         "type": "object",
         "properties": {
           "package_url": {
@@ -76383,8 +76743,6 @@
         "additionalProperties": false
       },
       "manifest": {
-        "title": "manifest",
-        "description": "A collection of related dependencies declared in a file or representing a logical group of dependencies.",
         "type": "object",
         "properties": {
           "name": {
@@ -76407,6 +76765,8 @@
             "$ref": "#/components/schemas/metadata"
           },
           "resolved": {
+            "type": "object",
+            "description": "A collection of resolved package dependencies.",
             "additionalProperties": {
               "$ref": "#/components/schemas/dependency"
             }
@@ -76495,7 +76855,7 @@
           },
           "manifests": {
             "type": "object",
-            "description": "A collection of package manifests",
+            "description": "A collection of package manifests, which are a collection of related dependencies declared in a file or representing a logical group of dependencies.",
             "additionalProperties": {
               "$ref": "#/components/schemas/manifest"
             }
@@ -81367,6 +81727,9 @@
                   },
                   "is_template": {
                     "type": "boolean"
+                  },
+                  "web_commit_signoff_required": {
+                    "type": "boolean"
                   }
                 },
                 "required": [
@@ -81941,6 +82304,9 @@
                   },
                   "allow_forking": {
                     "type": "boolean"
+                  },
+                  "web_commit_signoff_required": {
+                    "type": "boolean"
                   }
                 },
                 "required": [
@@ -84730,6 +85096,10 @@
           },
           "is_template": {
             "type": "boolean"
+          },
+          "web_commit_signoff_required": {
+            "type": "boolean",
+            "example": false
           }
         },
         "required": [
@@ -85858,7 +86228,7 @@
           "node_id"
         ]
       },
-      "merge-group-checks-requested": {
+      "webhook-merge-group-checks-requested": {
         "type": "object",
         "properties": {
           "action": {
@@ -85867,33 +86237,33 @@
           "installation": {
             "$ref": "#/components/schemas/simple-installation"
           },
-          "organization": {
-            "$ref": "#/components/schemas/organization-simple"
-          },
-          "repository": {
-            "$ref": "#/components/schemas/repository"
-          },
-          "sender": {
-            "$ref": "#/components/schemas/simple-user"
-          },
           "merge_group": {
             "type": "object",
-            "required": [
-              "head_sha",
-              "head_ref",
-              "base_ref"
-            ],
             "properties": {
-              "head_sha": {
+              "base_ref": {
                 "type": "string"
               },
               "head_ref": {
                 "type": "string"
               },
-              "base_ref": {
+              "head_sha": {
                 "type": "string"
               }
-            }
+            },
+            "required": [
+              "head_sha",
+              "head_ref",
+              "base_ref"
+            ]
+          },
+          "organization": {
+            "$ref": "#/components/schemas/organization-simple"
+          },
+          "repository": {
+            "$ref": "#/components/schemas/repository"
+          },
+          "sender": {
+            "$ref": "#/components/schemas/simple-user"
           }
         },
         "required": [
@@ -90844,6 +91214,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"
         }
       },
@@ -95268,6 +95639,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": {