@octokit/openapi 7.0.0 → 7.1.0

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

@@ -1,7 +1,7 @@
 {
   "openapi": "3.0.3",
   "info": {
-    "version": "7.0.0",
+    "version": "7.1.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."
@@ -4150,7 +4150,7 @@
               "examples": {
                 "default": {
                   "value": {
-                    "respoitory": "Hello-World",
+                    "repository": "Hello-World",
                     "permissions": {
                       "issues": "write",
                       "contents": "read"
@@ -67482,6 +67482,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": [
@@ -85596,6 +85609,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 +85788,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 +119267,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 +137597,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 +137639,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 +137670,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 +137711,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 +204853,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": [
@@ -207541,6 +207573,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 +207752,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 +209939,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 +210118,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",
@@ -211892,14 +211954,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 +232339,13 @@
                         "type": "object",
                         "properties": {
                           "type": {
-                            "type": "string"
+                            "type": "string",
+                            "enum": [
+                              "dir",
+                              "file",
+                              "submodule",
+                              "symlink"
+                            ]
                           },
                           "size": {
                             "type": "integer"
@@ -232365,7 +232426,10 @@
                       "type": "object",
                       "properties": {
                         "type": {
-                          "type": "string"
+                          "type": "string",
+                          "enum": [
+                            "file"
+                          ]
                         },
                         "encoding": {
                           "type": "string"
@@ -232458,7 +232522,10 @@
                       "type": "object",
                       "properties": {
                         "type": {
-                          "type": "string"
+                          "type": "string",
+                          "enum": [
+                            "symlink"
+                          ]
                         },
                         "target": {
                           "type": "string"
@@ -232534,12 +232601,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",
@@ -239469,15 +239539,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 +240146,7 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
-          "category": "repos",
+          "category": "deployments",
           "subcategory": "environments"
         },
         "x-octokit": {}
@@ -240085,7 +240155,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 +240187,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 +240741,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 +240773,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 +240837,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 +241468,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 +241488,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",
@@ -345421,6 +346065,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 +346244,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 +348431,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 +348610,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 +365101,10 @@
                   "type": "object",
                   "properties": {
                     "type": {
-                      "type": "string"
+                      "type": "string",
+                      "enum": [
+                        "file"
+                      ]
                     },
                     "encoding": {
                       "type": "string"
@@ -364706,7 +365383,10 @@
                   "type": "object",
                   "properties": {
                     "type": {
-                      "type": "string"
+                      "type": "string",
+                      "enum": [
+                        "file"
+                      ]
                     },
                     "encoding": {
                       "type": "string"
@@ -382569,7 +383249,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 +383384,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 +383479,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 +383570,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 +383675,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 +415544,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 +418447,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 +418626,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 +420813,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 +420992,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 +426366,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 +426545,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 +428905,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 +429084,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 +432179,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 +432358,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 +434798,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 +434977,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",