@octokit/openapi 14.1.0 → 15.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "openapi": "3.0.3",
3
3
  "info": {
4
- "version": "14.1.0",
4
+ "version": "15.0.0",
5
5
  "title": "GitHub's official OpenAPI spec + Octokit extension",
6
6
  "description": "OpenAPI specs from https://github.com/github/rest-api-description with the 'x-octokit' extension required by the Octokit SDKs",
7
7
  "license": {
@@ -273,21 +273,7 @@
273
273
  "in": "query",
274
274
  "description": "If specified, only advisories for these ecosystems will be returned.",
275
275
  "schema": {
276
- "type": "string",
277
- "enum": [
278
- "actions",
279
- "composer",
280
- "erlang",
281
- "go",
282
- "maven",
283
- "npm",
284
- "nuget",
285
- "other",
286
- "pip",
287
- "pub",
288
- "rubygems",
289
- "rust"
290
- ]
276
+ "$ref": "#/components/schemas/security-advisory-ecosystems"
291
277
  }
292
278
  },
293
279
  {
@@ -5222,6 +5208,10 @@
5222
5208
  "type": "boolean",
5223
5209
  "description": "Whether GitHub Advanced Security is automatically enabled for new repositories. For more information, see \"[About GitHub Advanced Security](https://docs.github.com/enterprise-cloud@latest//get-started/learning-about-github/about-github-advanced-security).\""
5224
5210
  },
5211
+ "advanced_security_enabled_new_user_namespace_repos": {
5212
+ "type": "boolean",
5213
+ "description": "Whether GitHub Advanced Security is automatically enabled for new user namespace repositories. For more information, see \"[About GitHub Advanced Security](https://docs.github.com/enterprise-cloud@latest//get-started/learning-about-github/about-github-advanced-security).\""
5214
+ },
5225
5215
  "dependabot_alerts_enabled_for_new_repositories": {
5226
5216
  "type": "boolean",
5227
5217
  "description": "Whether Dependabot alerts are automatically enabled for new repositories. For more information, see \"[About Dependabot alerts](https://docs.github.com/enterprise-cloud@latest//code-security/dependabot/dependabot-alerts/about-dependabot-alerts).\""
@@ -15832,7 +15822,7 @@
15832
15822
  "/orgs/{org}/hooks": {
15833
15823
  "get": {
15834
15824
  "summary": "List organization webhooks",
15835
- "description": "",
15825
+ "description": "You must be an organization owner or have the \"Manage organization webhooks\" permission to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit webhooks \nthat they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
15836
15826
  "tags": [
15837
15827
  "orgs"
15838
15828
  ],
@@ -15890,7 +15880,7 @@
15890
15880
  },
15891
15881
  "post": {
15892
15882
  "summary": "Create an organization webhook",
15893
- "description": "Here's how you can create a hook that posts payloads in JSON format:",
15883
+ "description": "You must be an organization owner or have the \"Manage organization webhooks\" permission to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit webhooks \nthat they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
15894
15884
  "tags": [
15895
15885
  "orgs"
15896
15886
  ],
@@ -16027,7 +16017,7 @@
16027
16017
  "/orgs/{org}/hooks/{hook_id}": {
16028
16018
  "get": {
16029
16019
  "summary": "Get an organization webhook",
16030
- "description": "Returns a webhook configured in an organization. To get only the webhook `config` properties, see \"[Get a webhook configuration for an organization](/rest/orgs/webhooks#get-a-webhook-configuration-for-an-organization).\"",
16020
+ "description": "You must be an organization owner or have the \"Manage organization webhooks\" permission to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit webhooks \nthat they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
16031
16021
  "tags": [
16032
16022
  "orgs"
16033
16023
  ],
@@ -16074,7 +16064,7 @@
16074
16064
  },
16075
16065
  "patch": {
16076
16066
  "summary": "Update an organization webhook",
16077
- "description": "Updates a webhook configured in an organization. When you update a webhook, the `secret` will be overwritten. If you previously had a `secret` set, you must provide the same `secret` or set a new `secret` or the secret will be removed. If you are only updating individual webhook `config` properties, use \"[Update a webhook configuration for an organization](/rest/orgs/webhooks#update-a-webhook-configuration-for-an-organization).\"",
16067
+ "description": "You must be an organization owner or have the \"Manage organization webhooks\" permission to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit webhooks \nthat they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
16078
16068
  "tags": [
16079
16069
  "orgs"
16080
16070
  ],
@@ -16186,7 +16176,7 @@
16186
16176
  },
16187
16177
  "delete": {
16188
16178
  "summary": "Delete an organization webhook",
16189
- "description": "",
16179
+ "description": "You must be an organization owner or have the \"Manage organization webhooks\" permission to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit webhooks \nthat they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
16190
16180
  "tags": [
16191
16181
  "orgs"
16192
16182
  ],
@@ -16223,7 +16213,7 @@
16223
16213
  "/orgs/{org}/hooks/{hook_id}/config": {
16224
16214
  "get": {
16225
16215
  "summary": "Get a webhook configuration for an organization",
16226
- "description": "Returns the webhook configuration for an organization. To get more information about the webhook, including the `active` state and `events`, use \"[Get an organization webhook ](/rest/orgs/webhooks#get-an-organization-webhook).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org_hook` scope to use this endpoint.",
16216
+ "description": "You must be an organization owner or have the \"Manage organization webhooks\" permission to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit webhooks \nthat they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
16227
16217
  "tags": [
16228
16218
  "orgs"
16229
16219
  ],
@@ -16267,7 +16257,7 @@
16267
16257
  },
16268
16258
  "patch": {
16269
16259
  "summary": "Update a webhook configuration for an organization",
16270
- "description": "Updates the webhook configuration for an organization. To update more information about the webhook, including the `active` state and `events`, use \"[Update an organization webhook ](/rest/orgs/webhooks#update-an-organization-webhook).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org_hook` scope to use this endpoint.",
16260
+ "description": "You must be an organization owner or have the \"Manage organization webhooks\" permission to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit webhooks \nthat they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
16271
16261
  "tags": [
16272
16262
  "orgs"
16273
16263
  ],
@@ -16348,7 +16338,7 @@
16348
16338
  "/orgs/{org}/hooks/{hook_id}/deliveries": {
16349
16339
  "get": {
16350
16340
  "summary": "List deliveries for an organization webhook",
16351
- "description": "Returns a list of webhook deliveries for a webhook configured in an organization.",
16341
+ "description": "You must be an organization owner or have the \"Manage organization webhooks\" permission to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit webhooks \nthat they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
16352
16342
  "tags": [
16353
16343
  "orgs"
16354
16344
  ],
@@ -16417,7 +16407,7 @@
16417
16407
  "/orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id}": {
16418
16408
  "get": {
16419
16409
  "summary": "Get a webhook delivery for an organization webhook",
16420
- "description": "Returns a delivery for a webhook configured in an organization.",
16410
+ "description": "You must be an organization owner or have the \"Manage organization webhooks\" permission to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit webhooks \nthat they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
16421
16411
  "tags": [
16422
16412
  "orgs"
16423
16413
  ],
@@ -16472,7 +16462,7 @@
16472
16462
  "/orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id}/attempts": {
16473
16463
  "post": {
16474
16464
  "summary": "Redeliver a delivery for an organization webhook",
16475
- "description": "Redeliver a delivery for a webhook configured in an organization.",
16465
+ "description": "You must be an organization owner or have the \"Manage organization webhooks\" permission to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit webhooks \nthat they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
16476
16466
  "tags": [
16477
16467
  "orgs"
16478
16468
  ],
@@ -16515,7 +16505,7 @@
16515
16505
  "/orgs/{org}/hooks/{hook_id}/pings": {
16516
16506
  "post": {
16517
16507
  "summary": "Ping an organization webhook",
16518
- "description": "This will trigger a [ping event](https://docs.github.com/enterprise-cloud@latest//webhooks/#ping-event) to be sent to the hook.",
16508
+ "description": "You must be an organization owner or have the \"Manage organization webhooks\" permission to use this endpoint. \n\nOAuth app tokens and personal access tokens (classic) need `admin:org_hook` scope. OAuth apps cannot list, view, or edit webhooks \nthat they did not create and users cannot list, view, or edit webhooks that were created by OAuth apps.",
16519
16509
  "tags": [
16520
16510
  "orgs"
16521
16511
  ],
@@ -29304,7 +29294,7 @@
29304
29294
  "/repos/{owner}/{repo}/actions/runs": {
29305
29295
  "get": {
29306
29296
  "summary": "List workflow runs for a repository",
29307
- "description": "Lists all workflow runs for a repository. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-cloud@latest//rest/guides/getting-started-with-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint with a private repository.",
29297
+ "description": "Lists all workflow runs for a repository. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/enterprise-cloud@latest//rest/guides/getting-started-with-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint.\n\nOAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint with a private repository.\n\nThis API will return up to 1,000 results for each search when using the following parameters: `actor`, `branch`, `check_suite_id`, `created`, `event`, `head_sha`, `status`.",
29308
29298
  "tags": [
29309
29299
  "actions"
29310
29300
  ],
@@ -41731,6 +41721,9 @@
41731
41721
  "204": {
41732
41722
  "description": "Response"
41733
41723
  },
41724
+ "404": {
41725
+ "$ref": "#/components/responses/not_found"
41726
+ },
41734
41727
  "422": {
41735
41728
  "$ref": "#/components/responses/validation_failed"
41736
41729
  }
@@ -52383,6 +52376,9 @@
52383
52376
  "404": {
52384
52377
  "$ref": "#/components/responses/not_found"
52385
52378
  },
52379
+ "406": {
52380
+ "$ref": "#/components/responses/unacceptable"
52381
+ },
52386
52382
  "500": {
52387
52383
  "$ref": "#/components/responses/internal_error"
52388
52384
  },
@@ -58960,7 +58956,7 @@
58960
58956
  "/scim/v2/enterprises/{enterprise}/Groups": {
58961
58957
  "get": {
58962
58958
  "summary": "List provisioned SCIM groups for an enterprise",
58963
- "description": "**Note:** The SCIM API endpoints for GitHub Enterprise Cloud accounts with enterprise managed users are currently only accessible through published identity provider applications.\nPublic access to SCIM API endpoints are in *private* beta and are subject to change.\n\nLists provisioned SCIM groups in an enterprise.\n\nYou can improve query search time by using the `excludedAttributes` query parameter with a value of `members` to exclude members from the response.",
58959
+ "description": "**Note:** SCIM provisioning for users and groups using the REST API is in public beta and subject to change.\n\nLists provisioned SCIM groups in an enterprise.\n\nYou can improve query search time by using the `excludedAttributes` query parameter with a value of `members` to exclude members from the response.",
58964
58960
  "operationId": "enterprise-admin/list-provisioned-groups-enterprise",
58965
58961
  "tags": [
58966
58962
  "enterprise-admin",
@@ -59043,7 +59039,7 @@
59043
59039
  },
59044
59040
  "post": {
59045
59041
  "summary": "Provision a SCIM enterprise group",
59046
- "description": "**Note:** The SCIM API endpoints for GitHub Enterprise Cloud accounts with enterprise managed users are currently only accessible through published identity provider applications.\nPublic access to SCIM API endpoints are in *private* beta and are subject to change.\n\nCreates a SCIM group for an enterprise.\n\nWhen members are part of the group provisioning payload, they're designated as external group members. Providers are responsible for maintaining a mapping between the `externalId` and `id` for each user.",
59042
+ "description": "**Note:** SCIM provisioning for users and groups using the REST API is in public beta and subject to change.\n\nCreates a SCIM group for an enterprise.\n\nWhen members are part of the group provisioning payload, they're designated as external group members. Providers are responsible for maintaining a mapping between the `externalId` and `id` for each user.",
59047
59043
  "operationId": "enterprise-admin/provision-enterprise-group",
59048
59044
  "tags": [
59049
59045
  "enterprise-admin"
@@ -59125,7 +59121,7 @@
59125
59121
  "/scim/v2/enterprises/{enterprise}/Groups/{scim_group_id}": {
59126
59122
  "get": {
59127
59123
  "summary": "Get SCIM provisioning information for an enterprise group",
59128
- "description": "**Note:** The SCIM API endpoints for GitHub Enterprise Cloud accounts with enterprise managed users are currently only accessible through published identity provider applications.\nPublic access to SCIM API endpoints are in *private* beta and are subject to change.\n\nGets information about a SCIM group.",
59124
+ "description": "**Note:** SCIM provisioning for users and groups using the REST API is in public beta and subject to change.\n\nGets information about a SCIM group.",
59129
59125
  "operationId": "enterprise-admin/get-provisioning-information-for-enterprise-group",
59130
59126
  "tags": [
59131
59127
  "enterprise-admin"
@@ -59190,7 +59186,7 @@
59190
59186
  },
59191
59187
  "put": {
59192
59188
  "summary": "Set SCIM information for a provisioned enterprise group",
59193
- "description": "**Note:** The SCIM API endpoints for GitHub Enterprise Cloud accounts with enterprise managed users are currently only accessible through published identity provider applications.\nPublic access to SCIM API endpoints are in *private* beta and are subject to change.\n\nReplaces an existing provisioned group’s information.\n\nYou must provide all the information required for the group as if you were provisioning it for the first time. Any existing group information that you don't provide will be removed, including group membership. If you want to only update a specific attribute, use the [Update an attribute for a SCIM enterprise group](#update-an-attribute-for-a-scim-enterprise-group) endpoint instead.",
59189
+ "description": "**Note:** SCIM provisioning for users and groups using the REST API is in public beta and subject to change.\n\nReplaces an existing provisioned group’s information.\n\nYou must provide all the information required for the group as if you were provisioning it for the first time. Any existing group information that you don't provide will be removed, including group membership. If you want to only update a specific attribute, use the [Update an attribute for a SCIM enterprise group](#update-an-attribute-for-a-scim-enterprise-group) endpoint instead.",
59194
59190
  "operationId": "enterprise-admin/set-information-for-provisioned-enterprise-group",
59195
59191
  "tags": [
59196
59192
  "enterprise-admin"
@@ -59300,7 +59296,7 @@
59300
59296
  },
59301
59297
  "patch": {
59302
59298
  "summary": "Update an attribute for a SCIM enterprise group",
59303
- "description": "**Note:** The SCIM API endpoints for GitHub Enterprise Cloud accounts with enterprise managed users are currently only accessible through published identity provider applications.\nPublic access to SCIM API endpoints are in *private* beta and are subject to change.\n\nUpdate a provisioned group’s individual attributes.\n\nTo modify a group's values, you'll need to use a specific Operations JSON format which must include at least one of the following operations: add, remove, or replace. For examples and more information on this SCIM format, consult the [SCIM specification](https://tools.ietf.org/html/rfc7644#section-3.5.2). The update function can also be used to add group memberships.\n\nYou can submit group memberships individually or in batches for improved efficiency.\n\n**Note**: Memberships are referenced via a local user id. Ensure users are created before referencing them here.",
59299
+ "description": "**Note:** SCIM provisioning for users and groups using the REST API is in public beta and subject to change.\n\nUpdate a provisioned group’s individual attributes.\n\nTo modify a group's values, you'll need to use a specific Operations JSON format which must include at least one of the following operations: add, remove, or replace. For examples and more information on this SCIM format, consult the [SCIM specification](https://tools.ietf.org/html/rfc7644#section-3.5.2). The update function can also be used to add group memberships.\n\nYou can submit group memberships individually or in batches for improved efficiency.\n\n**Note**: Memberships are referenced via a local user id. Ensure users are created before referencing them here.",
59304
59300
  "operationId": "enterprise-admin/update-attribute-for-enterprise-group",
59305
59301
  "tags": [
59306
59302
  "enterprise-admin"
@@ -59420,7 +59416,7 @@
59420
59416
  },
59421
59417
  "delete": {
59422
59418
  "summary": "Delete a SCIM group from an enterprise",
59423
- "description": "**Note:** The SCIM API endpoints for GitHub Enterprise Cloud accounts with enterprise managed users are currently only accessible through published identity provider applications.\nPublic access to SCIM API endpoints are in *private* beta and are subject to change.\n\nDeletes a SCIM group from an enterprise.",
59419
+ "description": "**Note:** SCIM provisioning using the REST API is in public beta and subject to change.\n\nDeletes a SCIM group from an enterprise.",
59424
59420
  "operationId": "enterprise-admin/delete-scim-group-from-enterprise",
59425
59421
  "tags": [
59426
59422
  "enterprise-admin"
@@ -59472,7 +59468,7 @@
59472
59468
  "/scim/v2/enterprises/{enterprise}/Users": {
59473
59469
  "get": {
59474
59470
  "summary": "List SCIM provisioned identities for an enterprise",
59475
- "description": "**Note:** The SCIM API endpoints for GitHub Enterprise Cloud accounts with enterprise managed users are currently only accessible through published identity provider applications.\nPublic access to SCIM API endpoints are in *private* beta and are subject to change.\n\nLists provisioned SCIM enterprise members.\n\nWhen you remove a user with a SCIM-provisioned external identity from an enterprise using a `patch` with `active` flag to `false`, the user's metadata remains intact. This means they can potentially re-join the enterprise later. Although, while suspended, the user can't sign in. If you want to ensure the user can't re-join in the future, use the delete request. Only users who weren't permanently deleted will appear in the result list.",
59471
+ "description": "**Note:** SCIM provisioning for users and groups using the REST API is in public beta and subject to change.\n\nLists provisioned SCIM enterprise members.\n\nWhen you remove a user with a SCIM-provisioned external identity from an enterprise using a `patch` with `active` flag to `false`, the user's metadata remains intact. This means they can potentially re-join the enterprise later. Although, while suspended, the user can't sign in. If you want to ensure the user can't re-join in the future, use the delete request. Only users who weren't permanently deleted will appear in the result list.",
59476
59472
  "operationId": "enterprise-admin/list-provisioned-identities-enterprise",
59477
59473
  "tags": [
59478
59474
  "enterprise-admin"
@@ -59551,7 +59547,7 @@
59551
59547
  },
59552
59548
  "post": {
59553
59549
  "summary": "Provision a SCIM enterprise user",
59554
- "description": "**Note:** The SCIM API endpoints for GitHub Enterprise Cloud accounts with enterprise managed users are currently only accessible through published identity provider applications.\nPublic access to SCIM API endpoints are in *private* beta and are subject to change.\n\nCreates an external identity for a new SCIM enterprise user.\n\nSCIM is responsible for user provisioning, not authentication. The actual user authentication is handled by SAML. However, with SCIM enabled, users must first be provisioned via SCIM before they can sign in through SAML.",
59550
+ "description": "**Note:** SCIM provisioning for users and groups using the REST API is in public beta and subject to change.\n\nCreates an external identity for a new SCIM enterprise user.\n\nSCIM is responsible for user provisioning, not authentication. The actual user authentication is handled by SAML. However, with SCIM enabled, users must first be provisioned via SCIM before they can sign in through SAML.",
59555
59551
  "operationId": "enterprise-admin/provision-enterprise-user",
59556
59552
  "tags": [
59557
59553
  "enterprise-admin"
@@ -59633,7 +59629,7 @@
59633
59629
  "/scim/v2/enterprises/{enterprise}/Users/{scim_user_id}": {
59634
59630
  "get": {
59635
59631
  "summary": "Get SCIM provisioning information for an enterprise user",
59636
- "description": "**Note:** The SCIM API endpoints for GitHub Enterprise Cloud accounts with enterprise managed users are currently only accessible through published identity provider applications.\nPublic access to SCIM API endpoints are in *private* beta and are subject to change.\n\nGets information about a SCIM user.",
59632
+ "description": "**Note:** SCIM provisioning for users and groups using the REST API is in public beta and subject to change.\n\nGets information about a SCIM user.",
59637
59633
  "operationId": "enterprise-admin/get-provisioning-information-for-enterprise-user",
59638
59634
  "tags": [
59639
59635
  "enterprise-admin"
@@ -59695,7 +59691,7 @@
59695
59691
  },
59696
59692
  "put": {
59697
59693
  "summary": "Set SCIM information for a provisioned enterprise user",
59698
- "description": "**Note:** The SCIM API endpoints for GitHub Enterprise Cloud accounts with enterprise managed users are currently only accessible through published identity provider applications.\nPublic access to SCIM API endpoints are in *private* beta and are subject to change.\n\nReplaces an existing provisioned user's information.\n\nYou must supply complete user information, just as you would when provisioning them initially. Any previously existing data not provided will be deleted. To update only a specific attribute, refer to the [Update an attribute for a SCIM user](#update-an-attribute-for-a-scim-enterprise-user) endpoint.\n\n**Warning:** Setting `active: false` will suspend a user, and their handle and email will be obfuscated.",
59694
+ "description": "**Note:** SCIM provisioning for users and groups using the REST API is in public beta and subject to change.\n\nReplaces an existing provisioned user's information.\n\nYou must supply complete user information, just as you would when provisioning them initially. Any previously existing data not provided will be deleted. To update only a specific attribute, refer to the [Update an attribute for a SCIM user](#update-an-attribute-for-a-scim-enterprise-user) endpoint.\n\n**Warning:** Setting `active: false` will suspend a user, and their handle and email will be obfuscated.",
59699
59695
  "operationId": "enterprise-admin/set-information-for-provisioned-enterprise-user",
59700
59696
  "tags": [
59701
59697
  "enterprise-admin"
@@ -59775,7 +59771,7 @@
59775
59771
  },
59776
59772
  "patch": {
59777
59773
  "summary": "Update an attribute for a SCIM enterprise user",
59778
- "description": "**Note:** The SCIM API endpoints for GitHub Enterprise Cloud accounts with enterprise managed users are currently only accessible through published identity provider applications.\nPublic access to SCIM API endpoints are in *private* beta and are subject to change.\n\nUpdate a provisioned user's individual attributes.\n\nTo modify a user's attributes, you'll need to provide a `Operations` JSON formatted request that includes at least one of the following actions: add, remove, or replace. For specific examples and more information on the SCIM operations format, please refer to the [SCIM specification](https://tools.ietf.org/html/rfc7644#section-3.5.2).\n\n**Note:** Complex SCIM `path` selectors that include filters are not supported. For example, a `path` selector defined as `\"path\": \"emails[type eq \\\"work\\\"]\"` will be ineffective.\n\n**Warning:** Setting `active: false` will suspend a user, and their handle and email will be obfuscated.\n\n```\n{\n \"Operations\":[{\n \"op\":\"replace\",\n \"value\":{\n \"active\":false\n }\n }]\n}\n```",
59774
+ "description": "**Note:** SCIM provisioning for users and groups using the REST API is in public beta and subject to change.\n\nUpdate a provisioned user's individual attributes.\n\nTo modify a user's attributes, you'll need to provide a `Operations` JSON formatted request that includes at least one of the following actions: add, remove, or replace. For specific examples and more information on the SCIM operations format, please refer to the [SCIM specification](https://tools.ietf.org/html/rfc7644#section-3.5.2).\n\n**Note:** Complex SCIM `path` selectors that include filters are not supported. For example, a `path` selector defined as `\"path\": \"emails[type eq \\\"work\\\"]\"` will be ineffective.\n\n**Warning:** Setting `active: false` will suspend a user, and their handle and email will be obfuscated.\n\n```\n{\n \"Operations\":[{\n \"op\":\"replace\",\n \"value\":{\n \"active\":false\n }\n }]\n}\n```",
59779
59775
  "operationId": "enterprise-admin/update-attribute-for-enterprise-user",
59780
59776
  "tags": [
59781
59777
  "enterprise-admin"
@@ -59913,7 +59909,7 @@
59913
59909
  },
59914
59910
  "delete": {
59915
59911
  "summary": "Delete a SCIM user from an enterprise",
59916
- "description": "**Note:** The SCIM API endpoints for GitHub Enterprise Cloud accounts with enterprise managed users are currently only accessible through published identity provider applications.\nPublic access to SCIM API endpoints are in *private* beta and are subject to change.\n\nSuspends a SCIM user permanently from an enterprise. This action will: remove all the user's data, anonymize their login, email, and display name, erase all external identity SCIM attributes, delete the user's emails, avatar, PATs, SSH keys, OAuth authorizations, GPG keys, and SAML mappings. This action is irreversible.",
59912
+ "description": "**Note:** SCIM provisioning using the REST API is in public beta and subject to change.\n\nSuspends a SCIM user permanently from an enterprise. This action will: remove all the user's data, anonymize their login, email, and display name, erase all external identity SCIM attributes, delete the user's emails, avatar, PATs, SSH keys, OAuth authorizations, GPG keys, and SAML mappings. This action is irreversible.",
59917
59913
  "operationId": "enterprise-admin/delete-user-from-enterprise",
59918
59914
  "tags": [
59919
59915
  "enterprise-admin"
@@ -90340,8 +90336,7 @@
90340
90336
  },
90341
90337
  "repository-dispatch-sample.collected": {
90342
90338
  "post": {
90343
- "summary": "This event occurs when a GitHub App sends a `POST` request to `/repos/{owner}/{repo}/dispatches`. For more information, see [the REST API documentation for creating a repository dispatch event](https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#create-a-repository-dispatch-event).\n\nTo subscribe to this event, a GitHub App must have at least read-level access for the \"Contents\" repository permission.",
90344
- "description": "The `event_type` that was specified in the `POST /repos/{owner}/{repo}/dispatches` request body.",
90339
+ "summary": "This event occurs when a GitHub App sends a `POST` request to `/repos/{owner}/{repo}/dispatches`. For more information, see [the REST API documentation for creating a repository dispatch event](https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#create-a-repository-dispatch-event). In the payload, the `action` will be the `event_type` that was specified in the `POST /repos/{owner}/{repo}/dispatches` request body.\n\nTo subscribe to this event, a GitHub App must have at least read-level access for the \"Contents\" repository permission.",
90345
90340
  "operationId": "repository-dispatch/sample.collected",
90346
90341
  "externalDocs": {
90347
90342
  "url": "https://docs.github.com/enterprise-cloud@latest//webhooks/webhook-events-and-payloads#repository_dispatch"
@@ -94948,7 +94943,8 @@
94948
94943
  },
94949
94944
  "hub_url": {
94950
94945
  "type": "string",
94951
- "format": "uri-template"
94946
+ "format": "uri-template",
94947
+ "deprecated": true
94952
94948
  },
94953
94949
  "issue_search_url": {
94954
94950
  "type": "string",
@@ -95044,7 +95040,6 @@
95044
95040
  "followers_url",
95045
95041
  "following_url",
95046
95042
  "gists_url",
95047
- "hub_url",
95048
95043
  "issue_search_url",
95049
95044
  "issues_url",
95050
95045
  "keys_url",
@@ -99730,6 +99725,11 @@
99730
99725
  "example": false,
99731
99726
  "description": "Whether GitHub advanced security is automatically enabled for new repositories and repositories transferred to\nthis enterprise."
99732
99727
  },
99728
+ "advanced_security_enabled_for_new_user_namespace_repositories": {
99729
+ "type": "boolean",
99730
+ "example": false,
99731
+ "description": "Whether GitHub Advanced Security is automatically enabled for new user namespace repositories."
99732
+ },
99733
99733
  "dependabot_alerts_enabled_for_new_repositories": {
99734
99734
  "type": "boolean",
99735
99735
  "example": false,
@@ -108573,12 +108573,12 @@
108573
108573
  }
108574
108574
  }
108575
108575
  },
108576
- "repository-rule-params-thresholds": {
108577
- "title": "Thresholds",
108578
- "description": "This setting will not take effect unless at least one code scanning status check is enabled.",
108576
+ "repository-rule-params-code-scanning-threshold": {
108577
+ "title": "CodeScanningThreshold",
108578
+ "description": "A tool and its thresholds.",
108579
108579
  "type": "object",
108580
108580
  "properties": {
108581
- "code_scanning_alert_threshold": {
108581
+ "alerts": {
108582
108582
  "type": "string",
108583
108583
  "description": "Code scanning alert threshold",
108584
108584
  "enum": [
@@ -108588,7 +108588,7 @@
108588
108588
  "all"
108589
108589
  ]
108590
108590
  },
108591
- "code_scanning_security_alert_threshold": {
108591
+ "security_alerts": {
108592
108592
  "type": "string",
108593
108593
  "description": "Code scanning security alert threshold.",
108594
108594
  "enum": [
@@ -108598,11 +108598,16 @@
108598
108598
  "medium_or_higher",
108599
108599
  "all"
108600
108600
  ]
108601
+ },
108602
+ "tool": {
108603
+ "type": "string",
108604
+ "description": "The name of a code scanning tool"
108601
108605
  }
108602
108606
  },
108603
108607
  "required": [
108604
- "code_scanning_alert_threshold",
108605
- "code_scanning_security_alert_threshold"
108608
+ "alerts",
108609
+ "security_alerts",
108610
+ "tool"
108606
108611
  ]
108607
108612
  },
108608
108613
  "repository-rule": {
@@ -124253,6 +124258,64 @@
124253
124258
  "commit_url"
124254
124259
  ]
124255
124260
  },
124261
+ "secret-scanning-location-wiki-commit": {
124262
+ "description": "Represents a 'wiki_commit' secret scanning location type. This location type shows that a secret was detected inside a commit to a repository wiki.",
124263
+ "type": "object",
124264
+ "properties": {
124265
+ "path": {
124266
+ "type": "string",
124267
+ "description": "The file path of the wiki page",
124268
+ "example": "/example/Home.md"
124269
+ },
124270
+ "start_line": {
124271
+ "type": "number",
124272
+ "description": "Line number at which the secret starts in the file"
124273
+ },
124274
+ "end_line": {
124275
+ "type": "number",
124276
+ "description": "Line number at which the secret ends in the file"
124277
+ },
124278
+ "start_column": {
124279
+ "type": "number",
124280
+ "description": "The column at which the secret starts within the start line when the file is interpreted as 8-bit ASCII."
124281
+ },
124282
+ "end_column": {
124283
+ "type": "number",
124284
+ "description": "The column at which the secret ends within the end line when the file is interpreted as 8-bit ASCII."
124285
+ },
124286
+ "blob_sha": {
124287
+ "type": "string",
124288
+ "description": "SHA-1 hash ID of the associated blob",
124289
+ "example": "af5626b4a114abcb82d63db7c8082c3c4756e51b"
124290
+ },
124291
+ "page_url": {
124292
+ "type": "string",
124293
+ "description": "The GitHub URL to get the associated wiki page",
124294
+ "example": "https://github.com/octocat/Hello-World/wiki/Home/302c0b7e200761c9dd9b57e57db540ee0b4293a5"
124295
+ },
124296
+ "commit_sha": {
124297
+ "type": "string",
124298
+ "description": "SHA-1 hash ID of the associated commit",
124299
+ "example": "302c0b7e200761c9dd9b57e57db540ee0b4293a5"
124300
+ },
124301
+ "commit_url": {
124302
+ "type": "string",
124303
+ "description": "The GitHub URL to get the associated wiki commit",
124304
+ "example": "https://github.com/octocat/Hello-World/wiki/_compare/302c0b7e200761c9dd9b57e57db540ee0b4293a5"
124305
+ }
124306
+ },
124307
+ "required": [
124308
+ "path",
124309
+ "start_line",
124310
+ "end_line",
124311
+ "start_column",
124312
+ "end_column",
124313
+ "blob_sha",
124314
+ "page_url",
124315
+ "commit_sha",
124316
+ "commit_url"
124317
+ ]
124318
+ },
124256
124319
  "secret-scanning-location-issue-title": {
124257
124320
  "description": "Represents an 'issue_title' secret scanning location type. This location type shows that a secret was detected in the title of an issue.",
124258
124321
  "type": "object",
@@ -124425,6 +124488,7 @@
124425
124488
  "type": "string",
124426
124489
  "enum": [
124427
124490
  "commit",
124491
+ "wiki_commit",
124428
124492
  "issue_title",
124429
124493
  "issue_body",
124430
124494
  "issue_comment",
@@ -124445,6 +124509,9 @@
124445
124509
  {
124446
124510
  "$ref": "#/components/schemas/secret-scanning-location-commit"
124447
124511
  },
124512
+ {
124513
+ "$ref": "#/components/schemas/secret-scanning-location-wiki-commit"
124514
+ },
124448
124515
  {
124449
124516
  "$ref": "#/components/schemas/secret-scanning-location-issue-title"
124450
124517
  },
@@ -124480,11 +124547,7 @@
124480
124547
  }
124481
124548
  ]
124482
124549
  }
124483
- },
124484
- "required": [
124485
- "type",
124486
- "details"
124487
- ]
124550
+ }
124488
124551
  },
124489
124552
  "repository-advisory-create": {
124490
124553
  "type": "object",
@@ -272308,9 +272371,7 @@
272308
272371
  "properties": {
272309
272372
  "action": {
272310
272373
  "type": "string",
272311
- "enum": [
272312
- "sample.collected"
272313
- ]
272374
+ "description": "The `event_type` that was specified in the `POST /repos/{owner}/{repo}/dispatches` request body."
272314
272375
  },
272315
272376
  "branch": {
272316
272377
  "type": "string"
@@ -272318,7 +272379,8 @@
272318
272379
  "client_payload": {
272319
272380
  "type": "object",
272320
272381
  "nullable": true,
272321
- "additionalProperties": true
272382
+ "additionalProperties": true,
272383
+ "description": "The `client_payload` that was specified in the `POST /repos/{owner}/{repo}/dispatches` request body."
272322
272384
  },
272323
272385
  "enterprise": {
272324
272386
  "$ref": "#/components/schemas/enterprise-webhooks"
@@ -311822,6 +311884,20 @@
311822
311884
  "commit_url": "https://api.github.com/repos/octocat/hello-world/git/commits/f14d7debf9775f957cf4f1e8176da0786431f72b"
311823
311885
  }
311824
311886
  },
311887
+ {
311888
+ "type": "wiki_commit",
311889
+ "details": {
311890
+ "path": "/example/Home.md",
311891
+ "start_line": 1,
311892
+ "end_line": 1,
311893
+ "start_column": 1,
311894
+ "end_column": 64,
311895
+ "blob_sha": "af5626b4a114abcb82d63db7c8082c3c4756e51b",
311896
+ "page_url": "https://github.com/octocat/Hello-World/wiki/Home/302c0b7e200761c9dd9b57e57db540ee0b4293a5",
311897
+ "commit_sha": "302c0b7e200761c9dd9b57e57db540ee0b4293a5",
311898
+ "commit_url": "https://github.com/octocat/Hello-World/wiki/_compare/302c0b7e200761c9dd9b57e57db540ee0b4293a5"
311899
+ }
311900
+ },
311825
311901
  {
311826
311902
  "type": "issue_title",
311827
311903
  "details": {
@@ -319119,6 +319195,7 @@
319119
319195
  "type": "string",
319120
319196
  "enum": [
319121
319197
  "advanced_security",
319198
+ "advanced_security_user_namespace",
319122
319199
  "dependabot_alerts",
319123
319200
  "secret_scanning",
319124
319201
  "secret_scanning_push_protection"
@@ -320682,6 +320759,16 @@
320682
320759
  }
320683
320760
  }
320684
320761
  },
320762
+ "unacceptable": {
320763
+ "description": "Unacceptable",
320764
+ "content": {
320765
+ "application/json": {
320766
+ "schema": {
320767
+ "$ref": "#/components/schemas/basic-error"
320768
+ }
320769
+ }
320770
+ }
320771
+ },
320685
320772
  "scim_bad_request": {
320686
320773
  "description": "Bad request",
320687
320774
  "content": {