@octokit/openapi 7.0.0 → 7.3.0

package/generated/api.github.com.deref.json

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "7.0.0",
+    "version": "7.3.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": {
@@ -91,6 +91,10 @@
       "name": "markdown",
       "description": "Render GitHub flavored markdown"
     },
+    {
+      "name": "merge-queue",
+      "description": "Interact with GitHub Merge Queues."
+    },
     {
       "name": "meta",
       "description": "Endpoints that give information about the API."
@@ -99,10 +103,6 @@
       "name": "migrations",
       "description": "Move projects to or from GitHub."
     },
-    {
-      "name": "oauth-authorizations",
-      "description": "Manage access of OAuth applications"
-    },
     {
       "name": "oidc",
       "description": "Endpoints to manage GitHub OIDC configuration using the REST API."
@@ -2487,6 +2487,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.",
@@ -3276,6 +3284,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.",
@@ -3929,6 +3945,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.",
@@ -4150,7 +4174,7 @@
               "examples": {
                 "default": {
                   "value": {
-                    "respoitory": "Hello-World",
+                    "repository": "Hello-World",
                     "permissions": {
                       "issues": "write",
                       "contents": "read"
@@ -4214,6 +4238,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.",
@@ -6441,6 +6473,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.",
@@ -7284,6 +7324,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.",
@@ -8051,6 +8099,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.",
@@ -8526,6 +8582,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.",
@@ -19823,6 +19887,328 @@
         "x-octokit": {}
       }
     },
+    "/enterprises/{enterprise}/consumed-licenses": {
+      "get": {
+        "summary": "List enterprise consumed licenses",
+        "description": "Lists the license consumption information for all users, including those from connected servers, associated with an enterprise.\nTo use this endpoint, you must be an enterprise admin, and you must use an access\ntoken with the `read:enterprise` scope.",
+        "tags": [
+          "enterprise-admin"
+        ],
+        "operationId": "enterprise-admin/get-consumed-licenses",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/reference/enterprise-admin#list-enterprise-consumed-licenses"
+        },
+        "parameters": [
+          {
+            "name": "enterprise",
+            "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "per_page",
+            "description": "The number of results per page (max 100).",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "default": 30
+            }
+          },
+          {
+            "name": "page",
+            "description": "Page number of the results to fetch.",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "default": 1
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Consumed Licenses Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Enterprise Consumed Licenses",
+                  "description": "A breakdown of the licenses consumed by an enterprise.",
+                  "properties": {
+                    "total_seats_consumed": {
+                      "type": "integer"
+                    },
+                    "total_seats_purchased": {
+                      "type": "integer"
+                    },
+                    "users": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "github_com_login": {
+                            "type": "string"
+                          },
+                          "github_com_name": {
+                            "type": "string",
+                            "nullable": true
+                          },
+                          "github_com_profile": {
+                            "type": "string",
+                            "nullable": true
+                          },
+                          "license_type": {
+                            "type": "string"
+                          },
+                          "github_com_member_roles": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "github_com_enterprise_role": {
+                            "type": "string",
+                            "nullable": true
+                          },
+                          "visual_studio_subscription_user": {
+                            "type": "boolean"
+                          },
+                          "github_com_verified_domain_emails": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "github_com_saml_name_id": {
+                            "type": "string",
+                            "nullable": true
+                          },
+                          "enterprise_server_user": {
+                            "type": "boolean",
+                            "nullable": true
+                          },
+                          "enterprise_server_emails": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "github_com_user": {
+                            "type": "boolean"
+                          },
+                          "total_user_accounts": {
+                            "type": "integer"
+                          },
+                          "enterprise_server_user_ids": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "github_com_orgs_with_pending_invites": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "visual_studio_subscription_email": {
+                            "type": "string",
+                            "nullable": true
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "total_seats_consumed": 5000,
+                      "total_seats_purchased": 4500,
+                      "users": [
+                        {
+                          "enterprise_server_emails": [
+                            "monalisa@github.com"
+                          ],
+                          "github_com_login": "monalisa",
+                          "github_com_name": "Mona Lisa",
+                          "github_com_profile": "https://github.com/monalisa",
+                          "license_type": "enterprise",
+                          "github_com_member_roles": [
+                            "org1:Owner",
+                            "org2:Owner"
+                          ],
+                          "github_com_enterprise_role": "owner",
+                          "visual_studio_subscription_user": false,
+                          "github_com_verified_domain_emails": [
+                            "monalisa@github.com"
+                          ],
+                          "github_com_saml_name_id": "monalisa",
+                          "enterprise_server_user": true,
+                          "github_com_user": true,
+                          "total_user_accounts": 3,
+                          "enterprise_server_user_ids": [
+                            "example_host_name.com:123",
+                            "example_host_name_2:222"
+                          ],
+                          "github_com_orgs_with_pending_invites": [
+                            "org1",
+                            "org2"
+                          ],
+                          "visual_studio_subscription_email": ""
+                        },
+                        {
+                          "enterprise_server_emails": [
+                            "deleonjavier@example.com"
+                          ],
+                          "github_com_login": "",
+                          "github_com_name": "",
+                          "github_com_profile": "",
+                          "license_type": "enterprise",
+                          "github_com_member_roles": [],
+                          "github_com_enterprise_role": "",
+                          "visual_studio_subscription_user": false,
+                          "github_com_verified_domain_emails": [],
+                          "github_com_saml_name_id": "",
+                          "enterprise_server_user": true,
+                          "github_com_user": false,
+                          "total_user_accounts": 1,
+                          "enterprise_server_user_ids": [
+                            "example_host_name:123"
+                          ],
+                          "github_com_orgs_with_pending_invites": [],
+                          "visual_studio_subscription_email": ""
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            },
+            "headers": {
+              "Link": {
+                "example": "<https://api.github.com/resource?page=2>; rel=\"next\", <https://api.github.com/resource?page=5>; rel=\"last\"",
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": true,
+          "enabledForGitHubApps": false,
+          "previews": [],
+          "category": "enterprise-admin",
+          "subcategory": "license"
+        },
+        "x-octokit": {}
+      }
+    },
+    "/enterprises/{enterprise}/license-sync-status": {
+      "get": {
+        "summary": "Get a license sync status",
+        "description": "Gets information about the status of a license sync job for an enterprise.\nTo use this endpoint, you must be an enterprise admin, and you must use an access\ntoken with the `read:enterprise` scope.",
+        "tags": [
+          "enterprise-admin"
+        ],
+        "operationId": "enterprise-admin/get-license-sync-status",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/reference/enterprise-admin#get-a-license-sync-status"
+        },
+        "parameters": [
+          {
+            "name": "enterprise",
+            "description": "The slug version of the enterprise name. You can also substitute this value with the enterprise id.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "License Sync Status Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "License Sync Status",
+                  "description": "Information about the status of a license sync job for an enterprise.",
+                  "properties": {
+                    "server_instances": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "server_id": {
+                            "type": "string"
+                          },
+                          "hostname": {
+                            "type": "string"
+                          },
+                          "last_sync": {
+                            "type": "object",
+                            "properties": {
+                              "date": {
+                                "type": "string"
+                              },
+                              "status": {
+                                "type": "string"
+                              },
+                              "error": {
+                                "type": "string"
+                              }
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "server_instances": [
+                        {
+                          "server_id": "deadbeef1",
+                          "hostname": "github.example.com",
+                          "last_sync": {
+                            "date": "2020-01-01T00:00:00Z",
+                            "status": "success",
+                            "error": ""
+                          }
+                        },
+                        {
+                          "server_id": "filetoffish1",
+                          "hostname": "github2.example.com",
+                          "last_sync": {
+                            "date": "2020-01-01T00:00:00Z",
+                            "status": "success",
+                            "error": ""
+                          }
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": true,
+          "enabledForGitHubApps": false,
+          "previews": [],
+          "category": "enterprise-admin",
+          "subcategory": "license"
+        },
+        "x-octokit": {}
+      }
+    },
     "/enterprises/{enterprise}/secret-scanning/alerts": {
       "get": {
         "summary": "List secret scanning alerts for an enterprise",
@@ -67482,6 +67868,19 @@
                             "description": "Text to show user when codespace idle timeout minutes has been overriden by an organization policy",
                             "type": "string",
                             "nullable": true
+                          },
+                          "retention_period_minutes": {
+                            "description": "Duration in minutes after codespace has gone idle in which it will be deleted. Must be integer minutes between 0 and 43200 (30 days).",
+                            "type": "integer",
+                            "example": 60,
+                            "nullable": true
+                          },
+                          "retention_expires_at": {
+                            "description": "When a codespace will be auto-deleted based on the \"retention_period_minutes\" and \"last_used_at\"",
+                            "type": "string",
+                            "format": "date-time",
+                            "example": "2011-01-26T20:01:12Z",
+                            "nullable": true
                           }
                         },
                         "required": [
@@ -77244,6 +77643,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.",
@@ -78047,6 +78454,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.",
@@ -85596,6 +86011,19 @@
                       "description": "Text to show user when codespace idle timeout minutes has been overriden by an organization policy",
                       "type": "string",
                       "nullable": true
+                    },
+                    "retention_period_minutes": {
+                      "description": "Duration in minutes after codespace has gone idle in which it will be deleted. Must be integer minutes between 0 and 43200 (30 days).",
+                      "type": "integer",
+                      "example": 60,
+                      "nullable": true
+                    },
+                    "retention_expires_at": {
+                      "description": "When a codespace will be auto-deleted based on the \"retention_period_minutes\" and \"last_used_at\"",
+                      "type": "string",
+                      "format": "date-time",
+                      "example": "2011-01-26T20:01:12Z",
+                      "nullable": true
                     }
                   },
                   "required": [
@@ -85762,6 +86190,8 @@
                       },
                       "location": "WestUs2",
                       "idle_timeout_minutes": 60,
+                      "retention_period_minutes": "43200,",
+                      "retention_expires_at": "null,",
                       "web_url": "https://monalisa-octocat-hello-world-g4wpq6h95q.github.dev",
                       "machines_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/machines",
                       "start_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/start",
@@ -119239,14 +119669,7 @@
                 "properties": {
                   "permission": {
                     "type": "string",
-                    "description": "The permission to grant the team on this repository. In addition to the enumerated values, you can also specify a custom repository role name, if the owning organization has defined any. If no permission is specified, the team's `permission` attribute will be used to determine what permission to grant the team on this repository.",
-                    "enum": [
-                      "pull",
-                      "push",
-                      "admin",
-                      "maintain",
-                      "triage"
-                    ],
+                    "description": "The permission to grant the team on this repository. We accept the following permissions to be set: `pull`, `triage`, `push`, `maintain`, `admin` and you can also specify a custom repository role name, if the owning organization has defined any. If no permission is specified, the team's `permission` attribute will be used to determine what permission to grant the team on this repository.",
                     "default": "push"
                   }
                 }
@@ -137576,7 +137999,7 @@
     "/repos/{owner}/{repo}/actions/permissions/access": {
       "get": {
         "summary": "Get the level of access for workflows outside of the repository",
-        "description": "Gets the level of access that workflows outside of the repository have to actions and reusable workflows in the repository.\nThis endpoint only applies to internal and private repositories.\nFor more information, see \"[Managing GitHub Actions settings for a repository](https://docs.github.com/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#allowing-access-to-components-in-a-private-repository)\" for GitHub.com and\n\"[Managing GitHub Actions settings for a repository](https://docs.github.com/enterprise-cloud@latest/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#allowing-access-to-components-in-an-internal-repository)\" for GitHub Enterprise Cloud.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the\nrepository `administration` permission to use this endpoint.",
+        "description": "Gets the level of access that workflows outside of the repository have to actions and reusable workflows in the repository.\nThis endpoint only applies to internal repositories. For more information, see \"[Managing GitHub Actions settings for a repository](https://docs.github.com/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#allowing-access-to-components-in-an-internal-repository).\"\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the\nrepository `administration` permission to use this endpoint.",
         "tags": [
           "actions"
         ],
@@ -137618,7 +138041,6 @@
                       "description": "Defines the level of access that workflows outside of the repository have to actions and reusable workflows within the\nrepository. `none` means access is only possible from workflows in this repository.",
                       "enum": [
                         "none",
-                        "user",
                         "organization",
                         "enterprise"
                       ]
@@ -137650,7 +138072,7 @@
       },
       "put": {
         "summary": "Set the level of access for workflows outside of the repository",
-        "description": "Sets the level of access that workflows outside of the repository have to actions and reusable workflows in the repository.\nThis endpoint only applies to internal and private repositories.\nFor more information, see \"[Managing GitHub Actions settings for a repository](https://docs.github.com/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#allowing-access-to-components-in-a-private-repository)\" for GitHub.com and\n\"[Managing GitHub Actions settings for a repository](https://docs.github.com/enterprise-cloud@latest/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#allowing-access-to-components-in-an-internal-repository)\" for GitHub Enterprise Cloud.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the\nrepository `administration` permission to use this endpoint.",
+        "description": "Sets the level of access that workflows outside of the repository have to actions and reusable workflows in the repository.\nThis endpoint only applies to internal repositories. For more information, see \"[Managing GitHub Actions settings for a repository](https://docs.github.com/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#allowing-access-to-components-in-an-internal-repository).\"\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the\nrepository `administration` permission to use this endpoint.",
         "tags": [
           "actions"
         ],
@@ -137691,7 +138113,6 @@
                     "description": "Defines the level of access that workflows outside of the repository have to actions and reusable workflows within the\nrepository. `none` means access is only possible from workflows in this repository.",
                     "enum": [
                       "none",
-                      "user",
                       "organization",
                       "enterprise"
                     ]
@@ -204834,6 +205255,19 @@
                             "description": "Text to show user when codespace idle timeout minutes has been overriden by an organization policy",
                             "type": "string",
                             "nullable": true
+                          },
+                          "retention_period_minutes": {
+                            "description": "Duration in minutes after codespace has gone idle in which it will be deleted. Must be integer minutes between 0 and 43200 (30 days).",
+                            "type": "integer",
+                            "example": 60,
+                            "nullable": true
+                          },
+                          "retention_expires_at": {
+                            "description": "When a codespace will be auto-deleted based on the \"retention_period_minutes\" and \"last_used_at\"",
+                            "type": "string",
+                            "format": "date-time",
+                            "example": "2011-01-26T20:01:12Z",
+                            "nullable": true
                           }
                         },
                         "required": [
@@ -205359,8 +205793,8 @@
               "examples": {
                 "default": {
                   "value": {
-                    "repository_id": 1,
-                    "ref": "main"
+                    "ref": "main",
+                    "machine": "standardLinux32gb"
                   }
                 }
               }
@@ -207541,6 +207975,19 @@
                       "description": "Text to show user when codespace idle timeout minutes has been overriden by an organization policy",
                       "type": "string",
                       "nullable": true
+                    },
+                    "retention_period_minutes": {
+                      "description": "Duration in minutes after codespace has gone idle in which it will be deleted. Must be integer minutes between 0 and 43200 (30 days).",
+                      "type": "integer",
+                      "example": 60,
+                      "nullable": true
+                    },
+                    "retention_expires_at": {
+                      "description": "When a codespace will be auto-deleted based on the \"retention_period_minutes\" and \"last_used_at\"",
+                      "type": "string",
+                      "format": "date-time",
+                      "example": "2011-01-26T20:01:12Z",
+                      "nullable": true
                     }
                   },
                   "required": [
@@ -207707,6 +208154,8 @@
                       },
                       "location": "WestUs2",
                       "idle_timeout_minutes": 60,
+                      "retention_period_minutes": "43200,",
+                      "retention_expires_at": "null,",
                       "web_url": "https://monalisa-octocat-hello-world-g4wpq6h95q.github.dev",
                       "machines_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/machines",
                       "start_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/start",
@@ -209892,6 +210341,19 @@
                       "description": "Text to show user when codespace idle timeout minutes has been overriden by an organization policy",
                       "type": "string",
                       "nullable": true
+                    },
+                    "retention_period_minutes": {
+                      "description": "Duration in minutes after codespace has gone idle in which it will be deleted. Must be integer minutes between 0 and 43200 (30 days).",
+                      "type": "integer",
+                      "example": 60,
+                      "nullable": true
+                    },
+                    "retention_expires_at": {
+                      "description": "When a codespace will be auto-deleted based on the \"retention_period_minutes\" and \"last_used_at\"",
+                      "type": "string",
+                      "format": "date-time",
+                      "example": "2011-01-26T20:01:12Z",
+                      "nullable": true
                     }
                   },
                   "required": [
@@ -210058,6 +210520,8 @@
                       },
                       "location": "WestUs2",
                       "idle_timeout_minutes": 60,
+                      "retention_period_minutes": "43200,",
+                      "retention_expires_at": "null,",
                       "web_url": "https://monalisa-octocat-hello-world-g4wpq6h95q.github.dev",
                       "machines_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/machines",
                       "start_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/start",
@@ -210070,201 +210534,261 @@
               }
             }
           },
-          "401": {
-            "description": "Requires authentication",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "title": "Basic Error",
-                  "description": "Basic Error",
-                  "type": "object",
-                  "properties": {
-                    "message": {
-                      "type": "string"
-                    },
-                    "documentation_url": {
-                      "type": "string"
-                    },
-                    "url": {
-                      "type": "string"
-                    },
-                    "status": {
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "403": {
-            "description": "Forbidden",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "title": "Basic Error",
-                  "description": "Basic Error",
-                  "type": "object",
-                  "properties": {
-                    "message": {
-                      "type": "string"
-                    },
-                    "documentation_url": {
-                      "type": "string"
-                    },
-                    "url": {
-                      "type": "string"
-                    },
-                    "status": {
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "Resource not found",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "title": "Basic Error",
-                  "description": "Basic Error",
-                  "type": "object",
-                  "properties": {
-                    "message": {
-                      "type": "string"
-                    },
-                    "documentation_url": {
-                      "type": "string"
-                    },
-                    "url": {
-                      "type": "string"
-                    },
-                    "status": {
-                      "type": "string"
-                    }
-                  }
-                }
-              }
-            }
-          }
-        },
-        "x-github": {
-          "githubCloudOnly": false,
-          "enabledForGitHubApps": false,
-          "category": "codespaces",
-          "subcategory": null
-        },
-        "x-octokit": {}
-      }
-    },
-    "/repos/{owner}/{repo}/codespaces/devcontainers": {
-      "get": {
-        "summary": "List devcontainer configurations in a repository for the authenticated user",
-        "description": "Lists the devcontainer.json files associated with a specified repository and the authenticated user. These files\nspecify launchpoint configurations for codespaces created within the repository.\n\nYou must authenticate using an access token with the `codespace` scope to use this endpoint.\n\nGitHub Apps must have read access to the `codespaces_metadata` repository permission to use this endpoint.",
-        "tags": [
-          "codespaces"
-        ],
-        "operationId": "codespaces/list-devcontainers-in-repository-for-authenticated-user",
-        "externalDocs": {
-          "description": "API method documentation",
-          "url": "https://docs.github.com/rest/reference/codespaces#list-devcontainers-in-a-repository-for-the-authenticated-user"
-        },
-        "parameters": [
-          {
-            "name": "per_page",
-            "description": "The number of results per page (max 100).",
-            "in": "query",
-            "schema": {
-              "type": "integer",
-              "default": 30
-            }
-          },
-          {
-            "name": "page",
-            "description": "Page number of the results to fetch.",
-            "in": "query",
-            "schema": {
-              "type": "integer",
-              "default": 1
-            }
-          },
-          {
-            "name": "owner",
-            "description": "The account owner of the repository. The name is not case sensitive.",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          },
-          {
-            "name": "repo",
-            "description": "The name of the repository. The name is not case sensitive.",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Response",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "required": [
-                    "total_count",
-                    "devcontainers"
-                  ],
-                  "properties": {
-                    "total_count": {
-                      "type": "integer"
-                    },
-                    "devcontainers": {
-                      "type": "array",
-                      "items": {
-                        "type": "object",
-                        "required": [
-                          "path"
-                        ],
-                        "properties": {
-                          "path": {
-                            "type": "string"
-                          },
-                          "name": {
-                            "type": "string"
-                          }
-                        }
-                      }
-                    }
-                  }
-                },
-                "examples": {
-                  "default": {
-                    "value": {
-                      "devcontainers": [
-                        {
-                          "path": ".devcontainer/foobar/devcontainer.json",
-                          "name": "foobar"
-                        },
-                        {
-                          "path": ".devcontainer/devcontainer.json",
-                          "name": "kitchensink"
-                        },
-                        {
-                          "path": ".devcontainer.json"
-                        }
-                      ],
-                      "total_count": 3
-                    }
-                  }
-                }
-              }
-            }
-          },
+          "400": {
+            "description": "Bad Request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              },
+              "application/scim+json": {
+                "schema": {
+                  "title": "Scim Error",
+                  "description": "Scim Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "documentation_url": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "detail": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "status": {
+                      "type": "integer"
+                    },
+                    "scimType": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "schemas": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Requires authentication",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Basic Error",
+                  "description": "Basic Error",
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "documentation_url": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": false,
+          "category": "codespaces",
+          "subcategory": null
+        },
+        "x-octokit": {}
+      }
+    },
+    "/repos/{owner}/{repo}/codespaces/devcontainers": {
+      "get": {
+        "summary": "List devcontainer configurations in a repository for the authenticated user",
+        "description": "Lists the devcontainer.json files associated with a specified repository and the authenticated user. These files\nspecify launchpoint configurations for codespaces created within the repository.\n\nYou must authenticate using an access token with the `codespace` scope to use this endpoint.\n\nGitHub Apps must have read access to the `codespaces_metadata` repository permission to use this endpoint.",
+        "tags": [
+          "codespaces"
+        ],
+        "operationId": "codespaces/list-devcontainers-in-repository-for-authenticated-user",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/reference/codespaces#list-devcontainers-in-a-repository-for-the-authenticated-user"
+        },
+        "parameters": [
+          {
+            "name": "per_page",
+            "description": "The number of results per page (max 100).",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "default": 30
+            }
+          },
+          {
+            "name": "page",
+            "description": "Page number of the results to fetch.",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "default": 1
+            }
+          },
+          {
+            "name": "owner",
+            "description": "The account owner of the repository. The name is not case sensitive.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "repo",
+            "description": "The name of the repository. The name is not case sensitive.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "total_count",
+                    "devcontainers"
+                  ],
+                  "properties": {
+                    "total_count": {
+                      "type": "integer"
+                    },
+                    "devcontainers": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "path"
+                        ],
+                        "properties": {
+                          "path": {
+                            "type": "string"
+                          },
+                          "name": {
+                            "type": "string"
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "devcontainers": [
+                        {
+                          "path": ".devcontainer/foobar/devcontainer.json",
+                          "name": "foobar"
+                        },
+                        {
+                          "path": ".devcontainer/devcontainer.json",
+                          "name": "kitchensink"
+                        },
+                        {
+                          "path": ".devcontainer.json"
+                        }
+                      ],
+                      "total_count": 3
+                    }
+                  }
+                }
+              }
+            }
+          },
           "400": {
             "description": "Bad Request",
             "content": {
@@ -211892,14 +212416,7 @@
                 "properties": {
                   "permission": {
                     "type": "string",
-                    "description": "The permission to grant the collaborator. **Only valid on organization-owned repositories.** In addition to the enumerated values, you can also specify a custom repository role name, if the owning organization has defined any.",
-                    "enum": [
-                      "pull",
-                      "push",
-                      "admin",
-                      "maintain",
-                      "triage"
-                    ],
+                    "description": "The permission to grant the collaborator. **Only valid on organization-owned repositories.** We accept the following permissions to be set: `pull`, `triage`, `push`, `maintain`, `admin` and you can also specify a custom repository role name, if the owning organization has defined any.",
                     "default": "push"
                   }
                 }
@@ -232284,7 +232801,13 @@
                         "type": "object",
                         "properties": {
                           "type": {
-                            "type": "string"
+                            "type": "string",
+                            "enum": [
+                              "dir",
+                              "file",
+                              "submodule",
+                              "symlink"
+                            ]
                           },
                           "size": {
                             "type": "integer"
@@ -232365,7 +232888,10 @@
                       "type": "object",
                       "properties": {
                         "type": {
-                          "type": "string"
+                          "type": "string",
+                          "enum": [
+                            "file"
+                          ]
                         },
                         "encoding": {
                           "type": "string"
@@ -232458,7 +232984,10 @@
                       "type": "object",
                       "properties": {
                         "type": {
-                          "type": "string"
+                          "type": "string",
+                          "enum": [
+                            "symlink"
+                          ]
                         },
                         "target": {
                           "type": "string"
@@ -232534,12 +233063,15 @@
                       ]
                     },
                     {
-                      "title": "Symlink Content",
-                      "description": "An object describing a symlink",
+                      "title": "Submodule Content",
+                      "description": "An object describing a submodule",
                       "type": "object",
                       "properties": {
                         "type": {
-                          "type": "string"
+                          "type": "string",
+                          "enum": [
+                            "submodule"
+                          ]
                         },
                         "submodule_git_url": {
                           "type": "string",
@@ -235059,10 +235591,8 @@
                   },
                   "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": {
-                      "title": "manifest",
-                      "description": "A collection of related dependencies declared in a file or representing a logical group of dependencies.",
                       "type": "object",
                       "properties": {
                         "name": {
@@ -235102,9 +235632,9 @@
                           }
                         },
                         "resolved": {
+                          "type": "object",
+                          "description": "A collection of resolved package dependencies.",
                           "additionalProperties": {
-                            "title": "Dependency",
-                            "description": "A single package dependency.",
                             "type": "object",
                             "properties": {
                               "package_url": {
@@ -239469,15 +239999,15 @@
     },
     "/repos/{owner}/{repo}/environments": {
       "get": {
-        "summary": "Get all environments",
-        "description": "Get all environments for a repository.\n\nAnyone with read access to the repository can use this endpoint. If the repository is private, you must use an access token with the `repo` scope. GitHub Apps must have the `actions:read` permission to use this endpoint.",
+        "summary": "List environments",
+        "description": "Lists the environments for a repository.\n\nAnyone with read access to the repository can use this endpoint. If the repository is private, you must use an access token with the `repo` scope. GitHub Apps must have the `actions:read` permission to use this endpoint.",
         "tags": [
           "repos"
         ],
         "operationId": "repos/get-all-environments",
         "externalDocs": {
           "description": "API method documentation",
-          "url": "https://docs.github.com/rest/reference/repos#get-all-environments"
+          "url": "https://docs.github.com/rest/deployments/environments#list-environments"
         },
         "parameters": [
           {
@@ -240076,7 +240606,7 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
-          "category": "repos",
+          "category": "deployments",
           "subcategory": "environments"
         },
         "x-octokit": {}
@@ -240085,7 +240615,7 @@
     "/repos/{owner}/{repo}/environments/{environment_name}": {
       "get": {
         "summary": "Get an environment",
-        "description": "Anyone with read access to the repository can use this endpoint. If the repository is private, you must use an access token with the `repo` scope. GitHub Apps must have the `actions:read` permission to use this endpoint.",
+        "description": "**Note:** To get information about name patterns that branches must match in order to deploy to this environment, see \"[Get a deployment branch policy](/rest/deployments/branch-policies#get-a-deployment-branch-policy).\"\n\nAnyone with read access to the repository can use this endpoint. If the\nrepository is private, you must use an access token with the `repo` scope. GitHub\nApps must have the `actions:read` permission to use this endpoint.",
         "tags": [
           "repos"
         ],
@@ -240117,7 +240647,7 @@
             "name": "environment_name",
             "in": "path",
             "required": true,
-            "description": "The name of the environment",
+            "description": "The name of the environment.",
             "schema": {
               "type": "string"
             }
@@ -240671,7 +241201,7 @@
       },
       "put": {
         "summary": "Create or update an environment",
-        "description": "Create or update an environment with protection rules, such as required reviewers. For more information about environment protection rules, see \"[Environments](/actions/reference/environments#environment-protection-rules).\"\n\n**Note:** Although you can use this operation to specify that only branches that match specified name patterns can deploy to this environment, you must use the UI to set the name patterns. For more information, see \"[Environments](/actions/reference/environments#deployment-branches).\"\n\n**Note:** To create or update secrets for an environment, see \"[Secrets](/rest/reference/actions#secrets).\"\n\nYou must authenticate using an access token with the repo scope to use this endpoint.",
+        "description": "Create or update an environment with protection rules, such as required reviewers. For more information about environment protection rules, see \"[Environments](/actions/reference/environments#environment-protection-rules).\"\n\n**Note:** To create or update name patterns that branches must match in order to deploy to this environment, see \"[Deployment branch policies](/rest/deployments/branch-policies).\"\n\n**Note:** To create or update secrets for an environment, see \"[Secrets](/rest/reference/actions#secrets).\"\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `administration:write` permission for the repository to use this endpoint.",
         "tags": [
           "repos"
         ],
@@ -240703,7 +241233,7 @@
             "name": "environment_name",
             "in": "path",
             "required": true,
-            "description": "The name of the environment",
+            "description": "The name of the environment.",
             "schema": {
               "type": "string"
             }
@@ -240767,6 +241297,27 @@
                   }
                 },
                 "additionalProperties": false
+              },
+              "examples": {
+                "default": {
+                  "value": {
+                    "wait_timer": 30,
+                    "reviewers": [
+                      {
+                        "type": "User",
+                        "id": 1
+                      },
+                      {
+                        "type": "Team",
+                        "id": 1
+                      }
+                    ],
+                    "deployment_branch_policy": {
+                      "protected_branches": false,
+                      "custom_branch_policies": true
+                    }
+                  }
+                }
               }
             }
           }
@@ -241377,7 +241928,7 @@
             "name": "environment_name",
             "in": "path",
             "required": true,
-            "description": "The name of the environment",
+            "description": "The name of the environment.",
             "schema": {
               "type": "string"
             }
@@ -241397,6 +241948,559 @@
         "x-octokit": {}
       }
     },
+    "/repos/{owner}/{repo}/environments/{environment_name}/deployment-branch-policies": {
+      "get": {
+        "summary": "List deployment branch policies",
+        "description": "Lists the deployment branch policies for an environment.\n\nAnyone with read access to the repository can use this endpoint. If the repository is private, you must use an access token with the `repo` scope. GitHub Apps must have the `actions:read` permission to use this endpoint.",
+        "tags": [
+          "repos"
+        ],
+        "operationId": "repos/list-deployment-branch-policies",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/deployments/branch-policies#list-deployment-branch-policies"
+        },
+        "parameters": [
+          {
+            "name": "owner",
+            "description": "The account owner of the repository. The name is not case sensitive.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "repo",
+            "description": "The name of the repository. The name is not case sensitive.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "environment_name",
+            "in": "path",
+            "required": true,
+            "description": "The name of the environment.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "per_page",
+            "description": "The number of results per page (max 100).",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "default": 30
+            }
+          },
+          {
+            "name": "page",
+            "description": "Page number of the results to fetch.",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "default": 1
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "total_count": {
+                      "description": "The number of deployment branch policies for the environment.",
+                      "type": "integer",
+                      "example": 2
+                    },
+                    "branch_policies": {
+                      "type": "array",
+                      "items": {
+                        "title": "Deployment branch policy",
+                        "description": "Details of a deployment branch policy.",
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "description": "The unique identifier of the branch policy.",
+                            "type": "integer",
+                            "example": 361471
+                          },
+                          "node_id": {
+                            "type": "string",
+                            "example": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjE0NzE="
+                          },
+                          "name": {
+                            "description": "The name pattern that branches must match in order to deploy to the environment.",
+                            "type": "string",
+                            "example": "release/*"
+                          }
+                        }
+                      }
+                    }
+                  },
+                  "required": [
+                    "total_count",
+                    "branch_policies"
+                  ]
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "total_count": 2,
+                      "branch_policies": [
+                        {
+                          "id": 361471,
+                          "node_id": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjE0NzE=",
+                          "name": "release/*"
+                        },
+                        {
+                          "id": 361472,
+                          "node_id": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjE0NzI=",
+                          "name": "main"
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "deployments",
+          "subcategory": "branch-policies"
+        },
+        "x-octokit": {}
+      },
+      "post": {
+        "summary": "Create a deployment branch policy",
+        "description": "Creates a deployment branch policy for an environment.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `administration:write` permission for the repository to use this endpoint.",
+        "tags": [
+          "repos"
+        ],
+        "operationId": "repos/create-deployment-branch-policy",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/deployments/branch-policies#create-deployment-branch-policy"
+        },
+        "parameters": [
+          {
+            "name": "owner",
+            "description": "The account owner of the repository. The name is not case sensitive.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "repo",
+            "description": "The name of the repository. The name is not case sensitive.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "environment_name",
+            "in": "path",
+            "required": true,
+            "description": "The name of the environment.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "title": "Deployment branch policy name pattern",
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "description": "The name pattern that branches must match in order to deploy to the environment.\n\nWildcard characters will not match `/`. For example, to match branches that begin with `release/` and contain an additional single slash, use `release/*/*`.\nFor more information about pattern matching syntax, see the [Ruby File.fnmatch documentation](https://ruby-doc.org/core-2.5.1/File.html#method-c-fnmatch).",
+                    "type": "string",
+                    "example": "release/*"
+                  }
+                },
+                "required": [
+                  "name"
+                ]
+              },
+              "examples": {
+                "example-wildcard": {
+                  "summary": "Example of a wildcard name pattern",
+                  "value": {
+                    "name": "release/*"
+                  }
+                },
+                "example-single-branch": {
+                  "summary": "Example of a single branch name pattern",
+                  "value": {
+                    "name": "main"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Deployment branch policy",
+                  "description": "Details of a deployment branch policy.",
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "description": "The unique identifier of the branch policy.",
+                      "type": "integer",
+                      "example": 361471
+                    },
+                    "node_id": {
+                      "type": "string",
+                      "example": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjE0NzE="
+                    },
+                    "name": {
+                      "description": "The name pattern that branches must match in order to deploy to the environment.",
+                      "type": "string",
+                      "example": "release/*"
+                    }
+                  }
+                },
+                "examples": {
+                  "example-wildcard": {
+                    "value": {
+                      "id": 364662,
+                      "node_id": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjQ2NjI=",
+                      "name": "release/*"
+                    }
+                  },
+                  "example-single-branch": {
+                    "value": {
+                      "id": 364663,
+                      "node_id": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjQ2NjM=",
+                      "name": "main"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "303": {
+            "description": "Response if the same branch name pattern already exists"
+          },
+          "404": {
+            "description": "Not Found or `deployment_branch_policy.custom_branch_policies` property for the environment is set to false"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "deployments",
+          "subcategory": "branch-policies"
+        },
+        "x-octokit": {}
+      }
+    },
+    "/repos/{owner}/{repo}/environments/{environment_name}/deployment-branch-policies/{branch_policy_id}": {
+      "get": {
+        "summary": "Get a deployment branch policy",
+        "description": "Gets a deployment branch policy for an environment.\n\nAnyone with read access to the repository can use this endpoint. If the repository is private, you must use an access token with the `repo` scope. GitHub Apps must have the `actions:read` permission to use this endpoint.",
+        "tags": [
+          "repos"
+        ],
+        "operationId": "repos/get-deployment-branch-policy",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/deployments/branch-policies#get-deployment-branch-policy"
+        },
+        "parameters": [
+          {
+            "name": "owner",
+            "description": "The account owner of the repository. The name is not case sensitive.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "repo",
+            "description": "The name of the repository. The name is not case sensitive.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "environment_name",
+            "in": "path",
+            "required": true,
+            "description": "The name of the environment.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "branch_policy_id",
+            "in": "path",
+            "required": true,
+            "description": "The unique identifier of the branch policy.",
+            "schema": {
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Deployment branch policy",
+                  "description": "Details of a deployment branch policy.",
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "description": "The unique identifier of the branch policy.",
+                      "type": "integer",
+                      "example": 361471
+                    },
+                    "node_id": {
+                      "type": "string",
+                      "example": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjE0NzE="
+                    },
+                    "name": {
+                      "description": "The name pattern that branches must match in order to deploy to the environment.",
+                      "type": "string",
+                      "example": "release/*"
+                    }
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "id": 364662,
+                      "node_id": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjQ2NjI=",
+                      "name": "release/*"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "deployments",
+          "subcategory": "branch-policies"
+        },
+        "x-octokit": {}
+      },
+      "put": {
+        "summary": "Update a deployment branch policy",
+        "description": "Updates a deployment branch policy for an environment.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `administration:write` permission for the repository to use this endpoint.",
+        "tags": [
+          "repos"
+        ],
+        "operationId": "repos/update-deployment-branch-policy",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/deployments/branch-policies#update-deployment-branch-policy"
+        },
+        "parameters": [
+          {
+            "name": "owner",
+            "description": "The account owner of the repository. The name is not case sensitive.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "repo",
+            "description": "The name of the repository. The name is not case sensitive.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "environment_name",
+            "in": "path",
+            "required": true,
+            "description": "The name of the environment.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "branch_policy_id",
+            "in": "path",
+            "required": true,
+            "description": "The unique identifier of the branch policy.",
+            "schema": {
+              "type": "integer"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "title": "Deployment branch policy name pattern",
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "description": "The name pattern that branches must match in order to deploy to the environment.\n\nWildcard characters will not match `/`. For example, to match branches that begin with `release/` and contain an additional single slash, use `release/*/*`.\nFor more information about pattern matching syntax, see the [Ruby File.fnmatch documentation](https://ruby-doc.org/core-2.5.1/File.html#method-c-fnmatch).",
+                    "type": "string",
+                    "example": "release/*"
+                  }
+                },
+                "required": [
+                  "name"
+                ]
+              },
+              "examples": {
+                "default": {
+                  "value": {
+                    "name": "release/*"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "title": "Deployment branch policy",
+                  "description": "Details of a deployment branch policy.",
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "description": "The unique identifier of the branch policy.",
+                      "type": "integer",
+                      "example": 361471
+                    },
+                    "node_id": {
+                      "type": "string",
+                      "example": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjE0NzE="
+                    },
+                    "name": {
+                      "description": "The name pattern that branches must match in order to deploy to the environment.",
+                      "type": "string",
+                      "example": "release/*"
+                    }
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "value": {
+                      "id": 364662,
+                      "node_id": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjQ2NjI=",
+                      "name": "release/*"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "deployments",
+          "subcategory": "branch-policies"
+        },
+        "x-octokit": {}
+      },
+      "delete": {
+        "summary": "Delete a deployment branch policy",
+        "description": "Deletes a deployment branch policy for an environment.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `administration:write` permission for the repository to use this endpoint.",
+        "tags": [
+          "repos"
+        ],
+        "operationId": "repos/delete-deployment-branch-policy",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/deployments/branch-policies#delete-deployment-branch-policy"
+        },
+        "parameters": [
+          {
+            "name": "owner",
+            "description": "The account owner of the repository. The name is not case sensitive.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "repo",
+            "description": "The name of the repository. The name is not case sensitive.",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "environment_name",
+            "in": "path",
+            "required": true,
+            "description": "The name of the environment.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "branch_policy_id",
+            "in": "path",
+            "required": true,
+            "description": "The unique identifier of the branch policy.",
+            "schema": {
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Response"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "category": "deployments",
+          "subcategory": "branch-policies"
+        },
+        "x-octokit": {}
+      }
+    },
     "/repos/{owner}/{repo}/events": {
       "get": {
         "summary": "List repository events",
@@ -259617,6 +260721,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.",
@@ -345421,6 +346533,19 @@
                       "description": "Text to show user when codespace idle timeout minutes has been overriden by an organization policy",
                       "type": "string",
                       "nullable": true
+                    },
+                    "retention_period_minutes": {
+                      "description": "Duration in minutes after codespace has gone idle in which it will be deleted. Must be integer minutes between 0 and 43200 (30 days).",
+                      "type": "integer",
+                      "example": 60,
+                      "nullable": true
+                    },
+                    "retention_expires_at": {
+                      "description": "When a codespace will be auto-deleted based on the \"retention_period_minutes\" and \"last_used_at\"",
+                      "type": "string",
+                      "format": "date-time",
+                      "example": "2011-01-26T20:01:12Z",
+                      "nullable": true
                     }
                   },
                   "required": [
@@ -345587,6 +346712,8 @@
                       },
                       "location": "WestUs2",
                       "idle_timeout_minutes": 60,
+                      "retention_period_minutes": "43200,",
+                      "retention_expires_at": "null,",
                       "web_url": "https://monalisa-octocat-hello-world-g4wpq6h95q.github.dev",
                       "machines_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/machines",
                       "start_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/start",
@@ -347772,6 +348899,19 @@
                       "description": "Text to show user when codespace idle timeout minutes has been overriden by an organization policy",
                       "type": "string",
                       "nullable": true
+                    },
+                    "retention_period_minutes": {
+                      "description": "Duration in minutes after codespace has gone idle in which it will be deleted. Must be integer minutes between 0 and 43200 (30 days).",
+                      "type": "integer",
+                      "example": 60,
+                      "nullable": true
+                    },
+                    "retention_expires_at": {
+                      "description": "When a codespace will be auto-deleted based on the \"retention_period_minutes\" and \"last_used_at\"",
+                      "type": "string",
+                      "format": "date-time",
+                      "example": "2011-01-26T20:01:12Z",
+                      "nullable": true
                     }
                   },
                   "required": [
@@ -347938,6 +349078,8 @@
                       },
                       "location": "WestUs2",
                       "idle_timeout_minutes": 60,
+                      "retention_period_minutes": "43200,",
+                      "retention_expires_at": "null,",
                       "web_url": "https://monalisa-octocat-hello-world-g4wpq6h95q.github.dev",
                       "machines_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/machines",
                       "start_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/start",
@@ -364427,7 +365569,10 @@
                   "type": "object",
                   "properties": {
                     "type": {
-                      "type": "string"
+                      "type": "string",
+                      "enum": [
+                        "file"
+                      ]
                     },
                     "encoding": {
                       "type": "string"
@@ -364706,7 +365851,10 @@
                   "type": "object",
                   "properties": {
                     "type": {
-                      "type": "string"
+                      "type": "string",
+                      "enum": [
+                        "file"
+                      ]
                     },
                     "encoding": {
                       "type": "string"
@@ -382569,7 +383717,7 @@
             "name": "environment_name",
             "in": "path",
             "required": true,
-            "description": "The name of the environment",
+            "description": "The name of the environment.",
             "schema": {
               "type": "string"
             }
@@ -382704,7 +383852,7 @@
             "name": "environment_name",
             "in": "path",
             "required": true,
-            "description": "The name of the environment",
+            "description": "The name of the environment.",
             "schema": {
               "type": "string"
             }
@@ -382799,7 +383947,7 @@
             "name": "environment_name",
             "in": "path",
             "required": true,
-            "description": "The name of the environment",
+            "description": "The name of the environment.",
             "schema": {
               "type": "string"
             }
@@ -382890,7 +384038,7 @@
             "name": "environment_name",
             "in": "path",
             "required": true,
-            "description": "The name of the environment",
+            "description": "The name of the environment.",
             "schema": {
               "type": "string"
             }
@@ -382995,7 +384143,7 @@
             "name": "environment_name",
             "in": "path",
             "required": true,
-            "description": "The name of the environment",
+            "description": "The name of the environment.",
             "schema": {
               "type": "string"
             }
@@ -414864,6 +416012,19 @@
                             "description": "Text to show user when codespace idle timeout minutes has been overriden by an organization policy",
                             "type": "string",
                             "nullable": true
+                          },
+                          "retention_period_minutes": {
+                            "description": "Duration in minutes after codespace has gone idle in which it will be deleted. Must be integer minutes between 0 and 43200 (30 days).",
+                            "type": "integer",
+                            "example": 60,
+                            "nullable": true
+                          },
+                          "retention_expires_at": {
+                            "description": "When a codespace will be auto-deleted based on the \"retention_period_minutes\" and \"last_used_at\"",
+                            "type": "string",
+                            "format": "date-time",
+                            "example": "2011-01-26T20:01:12Z",
+                            "nullable": true
                           }
                         },
                         "required": [
@@ -417754,6 +418915,19 @@
                       "description": "Text to show user when codespace idle timeout minutes has been overriden by an organization policy",
                       "type": "string",
                       "nullable": true
+                    },
+                    "retention_period_minutes": {
+                      "description": "Duration in minutes after codespace has gone idle in which it will be deleted. Must be integer minutes between 0 and 43200 (30 days).",
+                      "type": "integer",
+                      "example": 60,
+                      "nullable": true
+                    },
+                    "retention_expires_at": {
+                      "description": "When a codespace will be auto-deleted based on the \"retention_period_minutes\" and \"last_used_at\"",
+                      "type": "string",
+                      "format": "date-time",
+                      "example": "2011-01-26T20:01:12Z",
+                      "nullable": true
                     }
                   },
                   "required": [
@@ -417920,6 +419094,8 @@
                       },
                       "location": "WestUs2",
                       "idle_timeout_minutes": 60,
+                      "retention_period_minutes": "43200,",
+                      "retention_expires_at": "null,",
                       "web_url": "https://monalisa-octocat-hello-world-g4wpq6h95q.github.dev",
                       "machines_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/machines",
                       "start_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/start",
@@ -420105,6 +421281,19 @@
                       "description": "Text to show user when codespace idle timeout minutes has been overriden by an organization policy",
                       "type": "string",
                       "nullable": true
+                    },
+                    "retention_period_minutes": {
+                      "description": "Duration in minutes after codespace has gone idle in which it will be deleted. Must be integer minutes between 0 and 43200 (30 days).",
+                      "type": "integer",
+                      "example": 60,
+                      "nullable": true
+                    },
+                    "retention_expires_at": {
+                      "description": "When a codespace will be auto-deleted based on the \"retention_period_minutes\" and \"last_used_at\"",
+                      "type": "string",
+                      "format": "date-time",
+                      "example": "2011-01-26T20:01:12Z",
+                      "nullable": true
                     }
                   },
                   "required": [
@@ -420271,6 +421460,8 @@
                       },
                       "location": "WestUs2",
                       "idle_timeout_minutes": 60,
+                      "retention_period_minutes": "43200,",
+                      "retention_expires_at": "null,",
                       "web_url": "https://monalisa-octocat-hello-world-g4wpq6h95q.github.dev",
                       "machines_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/machines",
                       "start_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/start",
@@ -425643,6 +426834,19 @@
                       "description": "Text to show user when codespace idle timeout minutes has been overriden by an organization policy",
                       "type": "string",
                       "nullable": true
+                    },
+                    "retention_period_minutes": {
+                      "description": "Duration in minutes after codespace has gone idle in which it will be deleted. Must be integer minutes between 0 and 43200 (30 days).",
+                      "type": "integer",
+                      "example": 60,
+                      "nullable": true
+                    },
+                    "retention_expires_at": {
+                      "description": "When a codespace will be auto-deleted based on the \"retention_period_minutes\" and \"last_used_at\"",
+                      "type": "string",
+                      "format": "date-time",
+                      "example": "2011-01-26T20:01:12Z",
+                      "nullable": true
                     }
                   },
                   "required": [
@@ -425809,6 +427013,8 @@
                       },
                       "location": "WestUs2",
                       "idle_timeout_minutes": 60,
+                      "retention_period_minutes": "43200,",
+                      "retention_expires_at": "null,",
                       "web_url": "https://monalisa-octocat-hello-world-g4wpq6h95q.github.dev",
                       "machines_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/machines",
                       "start_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/start",
@@ -428167,6 +429373,19 @@
                       "description": "Text to show user when codespace idle timeout minutes has been overriden by an organization policy",
                       "type": "string",
                       "nullable": true
+                    },
+                    "retention_period_minutes": {
+                      "description": "Duration in minutes after codespace has gone idle in which it will be deleted. Must be integer minutes between 0 and 43200 (30 days).",
+                      "type": "integer",
+                      "example": 60,
+                      "nullable": true
+                    },
+                    "retention_expires_at": {
+                      "description": "When a codespace will be auto-deleted based on the \"retention_period_minutes\" and \"last_used_at\"",
+                      "type": "string",
+                      "format": "date-time",
+                      "example": "2011-01-26T20:01:12Z",
+                      "nullable": true
                     }
                   },
                   "required": [
@@ -428333,6 +429552,8 @@
                       },
                       "location": "WestUs2",
                       "idle_timeout_minutes": 60,
+                      "retention_period_minutes": "43200,",
+                      "retention_expires_at": "null,",
                       "web_url": "https://monalisa-octocat-hello-world-g4wpq6h95q.github.dev",
                       "machines_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/machines",
                       "start_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/start",
@@ -431426,6 +432647,19 @@
                       "description": "Text to show user when codespace idle timeout minutes has been overriden by an organization policy",
                       "type": "string",
                       "nullable": true
+                    },
+                    "retention_period_minutes": {
+                      "description": "Duration in minutes after codespace has gone idle in which it will be deleted. Must be integer minutes between 0 and 43200 (30 days).",
+                      "type": "integer",
+                      "example": 60,
+                      "nullable": true
+                    },
+                    "retention_expires_at": {
+                      "description": "When a codespace will be auto-deleted based on the \"retention_period_minutes\" and \"last_used_at\"",
+                      "type": "string",
+                      "format": "date-time",
+                      "example": "2011-01-26T20:01:12Z",
+                      "nullable": true
                     }
                   },
                   "required": [
@@ -431592,6 +432826,8 @@
                       },
                       "location": "WestUs2",
                       "idle_timeout_minutes": 60,
+                      "retention_period_minutes": "43200,",
+                      "retention_expires_at": "null,",
                       "web_url": "https://monalisa-octocat-hello-world-g4wpq6h95q.github.dev",
                       "machines_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/machines",
                       "start_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/start",
@@ -434030,6 +435266,19 @@
                       "description": "Text to show user when codespace idle timeout minutes has been overriden by an organization policy",
                       "type": "string",
                       "nullable": true
+                    },
+                    "retention_period_minutes": {
+                      "description": "Duration in minutes after codespace has gone idle in which it will be deleted. Must be integer minutes between 0 and 43200 (30 days).",
+                      "type": "integer",
+                      "example": 60,
+                      "nullable": true
+                    },
+                    "retention_expires_at": {
+                      "description": "When a codespace will be auto-deleted based on the \"retention_period_minutes\" and \"last_used_at\"",
+                      "type": "string",
+                      "format": "date-time",
+                      "example": "2011-01-26T20:01:12Z",
+                      "nullable": true
                     }
                   },
                   "required": [
@@ -434196,6 +435445,8 @@
                       },
                       "location": "WestUs2",
                       "idle_timeout_minutes": 60,
+                      "retention_period_minutes": "43200,",
+                      "retention_expires_at": "null,",
                       "web_url": "https://monalisa-octocat-hello-world-g4wpq6h95q.github.dev",
                       "machines_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/machines",
                       "start_url": "https://api.github.com/user/codespaces/monalisa-octocat-hello-world-g4wpq6h95q/start",
@@ -437834,6 +439085,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.",
@@ -482236,6 +483495,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.",
@@ -501393,6 +502660,12 @@
               "text/plain": {
                 "schema": {
                   "type": "string"
+                },
+                "examples": {
+                  "default": {
+                    "summary": "Example response",
+                    "value": "Responsive is better than fast"
+                  }
                 }
               }
             }