@octokit/openapi 7.0.0 → 7.3.0

package/generated/api.github.com.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": {
@@ -3576,6 +3576,105 @@
         "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": [
+          {
+            "$ref": "#/components/parameters/enterprise"
+          },
+          {
+            "$ref": "#/components/parameters/per-page"
+          },
+          {
+            "$ref": "#/components/parameters/page"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Consumed Licenses Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/get-consumed-licenses"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/get-consumed-licenses"
+                  }
+                }
+              }
+            },
+            "headers": {
+              "Link": {
+                "$ref": "#/components/headers/link"
+              }
+            }
+          }
+        },
+        "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": [
+          {
+            "$ref": "#/components/parameters/enterprise"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "License Sync Status Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/get-license-sync-status"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/get-license-sync-status"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "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",
@@ -17139,14 +17238,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"
                   }
                 }
@@ -20155,7 +20247,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"
         ],
@@ -20200,7 +20292,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"
         ],
@@ -28025,8 +28117,8 @@
               "examples": {
                 "default": {
                   "value": {
-                    "repository_id": 1,
-                    "ref": "main"
+                    "ref": "main",
+                    "machine": "standardLinux32gb"
                   }
                 }
               }
@@ -28064,6 +28156,9 @@
               }
             }
           },
+          "400": {
+            "$ref": "#/components/responses/bad_request"
+          },
           "401": {
             "$ref": "#/components/responses/requires_authentication"
           },
@@ -28787,14 +28882,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"
                   }
                 }
@@ -31916,15 +32004,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": [
           {
@@ -31973,7 +32061,7 @@
         "x-github": {
           "githubCloudOnly": false,
           "enabledForGitHubApps": true,
-          "category": "repos",
+          "category": "deployments",
           "subcategory": "environments"
         },
         "x-octokit": {}
@@ -31982,7 +32070,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"
         ],
@@ -32029,7 +32117,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"
         ],
@@ -32079,10 +32167,31 @@
                     }
                   },
                   "deployment_branch_policy": {
-                    "$ref": "#/components/schemas/deployment-branch-policy"
+                    "$ref": "#/components/schemas/deployment-branch-policy-settings"
                   }
                 },
                 "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
+                    }
+                  }
+                }
               }
             }
           }
@@ -32158,6 +32267,315 @@
         "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": [
+          {
+            "$ref": "#/components/parameters/owner"
+          },
+          {
+            "$ref": "#/components/parameters/repo"
+          },
+          {
+            "$ref": "#/components/parameters/environment-name"
+          },
+          {
+            "$ref": "#/components/parameters/per-page"
+          },
+          {
+            "$ref": "#/components/parameters/page"
+          }
+        ],
+        "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": {
+                        "$ref": "#/components/schemas/deployment-branch-policy"
+                      }
+                    }
+                  },
+                  "required": [
+                    "total_count",
+                    "branch_policies"
+                  ]
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/deployment-branch-policies-list"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "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": [
+          {
+            "$ref": "#/components/parameters/owner"
+          },
+          {
+            "$ref": "#/components/parameters/repo"
+          },
+          {
+            "$ref": "#/components/parameters/environment-name"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/deployment-branch-policy-name-pattern"
+              },
+              "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": {
+                  "$ref": "#/components/schemas/deployment-branch-policy"
+                },
+                "examples": {
+                  "example-wildcard": {
+                    "$ref": "#/components/examples/deployment-branch-policy-wildcard"
+                  },
+                  "example-single-branch": {
+                    "$ref": "#/components/examples/deployment-branch-policy-single-branch"
+                  }
+                }
+              }
+            }
+          },
+          "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": [
+          {
+            "$ref": "#/components/parameters/owner"
+          },
+          {
+            "$ref": "#/components/parameters/repo"
+          },
+          {
+            "$ref": "#/components/parameters/environment-name"
+          },
+          {
+            "$ref": "#/components/parameters/branch-policy-id"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/deployment-branch-policy"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/deployment-branch-policy-wildcard"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "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": [
+          {
+            "$ref": "#/components/parameters/owner"
+          },
+          {
+            "$ref": "#/components/parameters/repo"
+          },
+          {
+            "$ref": "#/components/parameters/environment-name"
+          },
+          {
+            "$ref": "#/components/parameters/branch-policy-id"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/deployment-branch-policy-name-pattern"
+              },
+              "examples": {
+                "default": {
+                  "value": {
+                    "name": "release/*"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/deployment-branch-policy"
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/deployment-branch-policy-wildcard"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "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": [
+          {
+            "$ref": "#/components/parameters/owner"
+          },
+          {
+            "$ref": "#/components/parameters/repo"
+          },
+          {
+            "$ref": "#/components/parameters/environment-name"
+          },
+          {
+            "$ref": "#/components/parameters/branch-policy-id"
+          }
+        ],
+        "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",
@@ -58275,6 +58693,12 @@
               "text/plain": {
                 "schema": {
                   "type": "string"
+                },
+                "examples": {
+                  "default": {
+                    "summary": "Example response",
+                    "value": "Responsive is better than fast"
+                  }
                 }
               }
             }
@@ -59399,6 +59823,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.",
@@ -62252,6 +62684,129 @@
           "repository"
         ]
       },
+      "get-consumed-licenses": {
+        "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
+                }
+              }
+            }
+          }
+        }
+      },
+      "get-license-sync-status": {
+        "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"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
       "nullable-alert-updated-at": {
         "type": "string",
         "description": "The time that the alert was last updated in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.",
@@ -66668,6 +67223,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": [
@@ -70530,7 +71098,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"
             ]
@@ -75064,7 +75631,13 @@
           "type": "object",
           "properties": {
             "type": {
-              "type": "string"
+              "type": "string",
+              "enum": [
+                "dir",
+                "file",
+                "submodule",
+                "symlink"
+              ]
             },
             "size": {
               "type": "integer"
@@ -75145,7 +75718,10 @@
         "type": "object",
         "properties": {
           "type": {
-            "type": "string"
+            "type": "string",
+            "enum": [
+              "file"
+            ]
           },
           "encoding": {
             "type": "string"
@@ -75238,7 +75814,10 @@
         "type": "object",
         "properties": {
           "type": {
-            "type": "string"
+            "type": "string",
+            "enum": [
+              "symlink"
+            ]
           },
           "target": {
             "type": "string"
@@ -75314,12 +75893,15 @@
         ]
       },
       "content-submodule": {
-        "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",
@@ -75766,8 +76348,6 @@
         }
       },
       "dependency": {
-        "title": "Dependency",
-        "description": "A single package dependency.",
         "type": "object",
         "properties": {
           "package_url": {
@@ -75809,8 +76389,6 @@
         "additionalProperties": false
       },
       "manifest": {
-        "title": "manifest",
-        "description": "A collection of related dependencies declared in a file or representing a logical group of dependencies.",
         "type": "object",
         "properties": {
           "name": {
@@ -75833,6 +76411,8 @@
             "$ref": "#/components/schemas/metadata"
           },
           "resolved": {
+            "type": "object",
+            "description": "A collection of resolved package dependencies.",
             "additionalProperties": {
               "$ref": "#/components/schemas/dependency"
             }
@@ -75921,7 +76501,7 @@
           },
           "manifests": {
             "type": "object",
-            "description": "A collection of package manifests",
+            "description": "A collection of package manifests, which are a collection of related dependencies declared in a file or representing a logical group of dependencies.",
             "additionalProperties": {
               "$ref": "#/components/schemas/manifest"
             }
@@ -76055,7 +76635,7 @@
         "example": 30,
         "description": "The amount of time to delay a job after the job is initially triggered. The time (in minutes) must be an integer between 0 and 43,200 (30 days)."
       },
-      "deployment-branch-policy": {
+      "deployment-branch-policy-settings": {
         "type": "object",
         "description": "The type of deployment branch policy for this environment. To allow all branches to deploy, set to `null`.",
         "properties": {
@@ -76212,7 +76792,7 @@
             }
           },
           "deployment_branch_policy": {
-            "$ref": "#/components/schemas/deployment-branch-policy"
+            "$ref": "#/components/schemas/deployment-branch-policy-settings"
           }
         },
         "required": [
@@ -76225,6 +76805,41 @@
           "updated_at"
         ]
       },
+      "deployment-branch-policy": {
+        "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/*"
+          }
+        }
+      },
+      "deployment-branch-policy-name-pattern": {
+        "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"
+        ]
+      },
       "short-blob": {
         "title": "Short Blob",
         "description": "Short Blob",
@@ -85249,7 +85864,7 @@
           "node_id"
         ]
       },
-      "merge-group-checks-requested": {
+      "webhook-merge-group-checks-requested": {
         "type": "object",
         "properties": {
           "action": {
@@ -85258,33 +85873,33 @@
           "installation": {
             "$ref": "#/components/schemas/simple-installation"
           },
-          "organization": {
-            "$ref": "#/components/schemas/organization-simple"
-          },
-          "repository": {
-            "$ref": "#/components/schemas/repository"
-          },
-          "sender": {
-            "$ref": "#/components/schemas/simple-user"
-          },
           "merge_group": {
             "type": "object",
-            "required": [
-              "head_sha",
-              "head_ref",
-              "base_ref"
-            ],
             "properties": {
-              "head_sha": {
+              "base_ref": {
                 "type": "string"
               },
               "head_ref": {
                 "type": "string"
               },
-              "base_ref": {
+              "head_sha": {
                 "type": "string"
               }
-            }
+            },
+            "required": [
+              "head_sha",
+              "head_ref",
+              "base_ref"
+            ]
+          },
+          "organization": {
+            "$ref": "#/components/schemas/organization-simple"
+          },
+          "repository": {
+            "$ref": "#/components/schemas/repository"
+          },
+          "sender": {
+            "$ref": "#/components/schemas/simple-user"
           }
         },
         "required": [
@@ -88440,6 +89055,91 @@
           }
         ]
       },
+      "get-consumed-licenses": {
+        "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": ""
+            }
+          ]
+        }
+      },
+      "get-license-sync-status": {
+        "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": ""
+              }
+            }
+          ]
+        }
+      },
       "organization-secret-scanning-alert-list": {
         "value": [
           {
@@ -91807,6 +92507,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",
@@ -100590,6 +101292,37 @@
           }
         }
       },
+      "deployment-branch-policies-list": {
+        "value": {
+          "total_count": 2,
+          "branch_policies": [
+            {
+              "id": 361471,
+              "node_id": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjE0NzE=",
+              "name": "release/*"
+            },
+            {
+              "id": 361472,
+              "node_id": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjE0NzI=",
+              "name": "main"
+            }
+          ]
+        }
+      },
+      "deployment-branch-policy-wildcard": {
+        "value": {
+          "id": 364662,
+          "node_id": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjQ2NjI=",
+          "name": "release/*"
+        }
+      },
+      "deployment-branch-policy-single-branch": {
+        "value": {
+          "id": 364663,
+          "node_id": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjQ2NjM=",
+          "name": "main"
+        }
+      },
       "repo-events-items": {
         "value": [
           {
@@ -111240,11 +111973,20 @@
         "name": "environment_name",
         "in": "path",
         "required": true,
-        "description": "The name of the environment",
+        "description": "The name of the environment.",
         "schema": {
           "type": "string"
         }
       },
+      "branch-policy-id": {
+        "name": "branch_policy_id",
+        "in": "path",
+        "required": true,
+        "description": "The unique identifier of the branch policy.",
+        "schema": {
+          "type": "integer"
+        }
+      },
       "since-user": {
         "name": "since",
         "description": "A user ID. Only return users with an ID greater than this ID.",